A SYSTEM, METHOD AND ARTICLE OF MANUFACTURE FOR A 
GOAL BASED SYSTEM UTILIZING A TABLE BASED ARCHITECTURE 
Field Of The Invention 

The present invention relates to education systems and more particularly to a rule based tutorial system that utilizes a 
table of components to control business simulations of actual environments to teach new skills. 

Background of the Invention 
When building a knowledge based system or expert system, at least two disciplines are necessary to properly construct 
the rules that drive the knowledge base, the discipline of the knowledge engineer and the knowledge of the expert. The domain 
expert has knowledge of the domain or field of use of the expert system. For example, the domain expert of an expert for 
instructing students in an automotive manufacturing facility might be a process control engineer while the domain expert for a 
medical instruction system might be a doctor or a nurse. The knowledge engineer is a person that understands the expert system 
and utilizes the expert's knowledge to create an application for the system. In many instances, the knowledge engineer and 
domain expert are separate people who have to collaborate to construct the expert system. 

Typically, this collaboration takes the form of the knowledge engineer asking questions of the domain expert and 
incorporating the answers to these questions into the design of the system. This approach is labor intensive, slow and error 
prone. The coordination of the two separate disciplines may lead to problems. Although the knowledge engineer can transcribe 
input from the expert utilizing videotape, audio tape, text and other sources, efforts from people of both disciplines hsvo to oa 
expended. Further, if the knowledge engineer does not ask the right questions or asks the questions in an incorrect way, the 
information utilized to design the knowledge base could be incorrect. Feedback to the knowledge engineer from the expert 
system is often not available in prior art system until the construction is completed. With conventional system, there is a time 
consuming feedback loop that ties together various processes from knowledge acquisition to validation. 

Educational systems utilizing an expert system component often suffer from a lack of motivational aspects that result in 
a user becoming bored or ceasing to complete a training program. Current training programs utilize static, hard-coded feedback 
with some linear video and graphics used to add visual appeal and illustrate concepts. These systems typically support one 
"correct" answer and navigation through the system is only supported through a single defined path which results in a hvo- 
dimensional generic interaction, with no business model support and a single feedback to the learner of correct or incorrect 
based on the selected response. Current tutonal systems do not architect real business simulations into the rules to provide a 
aeative learning environment to a user. 

SUMMARY OF THE INVENTION 

According to a broad aspect of a preferred embodiment of the invention, a goal based learning system utilizes a rule 
based expert training system to provide a cognitive educational experience. The system provides the user with a simulated 
environment that presents a business opportunity to understand and solve optimally. Mistakes are noted and remedial 
educational material presented dynamically to build the necessary skills that a user requires for success in the business 
endeavor. The system utilizes an artificial intelligence engine dnving individualized and dynamic feedback with synchronized 
video and graphics used to simulate real-world environment and interactions. Multiple "correct" answers are integrated into the 
learning system to allow individualized learning experiences in which navigation through the system is at a pace controlled by the 
learner. A robust business model provides support for realistic activities and allows a user to experience real world 
consequences for their acBons and decisions and entails realtime decision-making and synthesis of the educational maferial. me 
system is architected around a table of components to manage and control the system. 



DESCRIPTION OF THE DRAWINGS 

ig and other objects, aspects and advantages are better understood from tt,e following detailed description 
or a preferred embodiment of the invention with reference to the drawings, in which: 

Figure 1 is a block diagram of a representative hardware environment in accordance with a preferred embodiment; 
Figure 2 is a block diagram of a system architecture in accordance with a preferred embodiment; 
Figure 3 depicts the timeline and relative resource requirements for each phase of development for a typical applkafion 
development in accordance witfi a preferred embodiment; 

Figure 4 illustrates a small segment of a domain model for claims handlers in the auto insurance industry in 
accordance with a preferred embodiment; 

Figure 5 illustrates an insurance underwriting profile in accordance with a preferred embodiment; 
Figure 6 illustrates a transformation component in accordance with a preferred embodiment; 
Figure 7 illustrates the use of a toolbar to navigate and access application level features in accordance with a preferred 
embodiment; 

Figure 8 is a GBS display in accordance vrith a preferred embodiment; 
Figure 9 is a feedback display in accordance with a preferred embodiment; 
Figure 10 illustrates a journal entry simulation in accordance with a preferred embodiment; 
Figure 1 1 illustrates a simulated Bell Phone Bill journal entry in accordance with a preferred embodiment; 
Figure 12 illustrates a feedback display in accordance with a preferred embodiment; 
Figure 13 illustrates the steps of the first scenario in accordance with a preferred embodiment; 
Figure 14 and 15 illustrate the steps associated with a build scenario in accordance with a preferred embodiment; 
Figure 16 illustrates a test scenario in accordance with a preferred embodiment. The test students work through the 
journalization activity; 

Figure 17 niuslrates how the tool suite supports student administration in accordance with a preferred embodiment; 
Figure 18 illustrates a suite to support a student interaction in accordance with a preferred embodiment; 
Figure 19 illustrates the remediation process in accordance with a preferred embodiment; 
Figure 20 illustrates the objects for the journalization task in accordance with a preferred embodiment; 
Figure 21 illustrates the mapping of a source item to a target item in accordance with a preferred embodiment; 
Figure 22 illustrates an analysis of rutes in accordance with a preferred embodiment; 
Figure 23 illustrates a feedback selection in accordance with a preferred embodiment; 
Figure 24 is a flowchart of the feedback logic in accordance with a preferred embodiment; 
Figure 25 is a block diagram setting forth the architecture of a simulation model in accordance with a preferred 
embodiment; 

Figure 26 illustrates the steps for configuring a simulation in accordance with a preferred embodiment; 
Figure 27 is a block diagram presenting the detailed architecture of a system dynamics model in accordance with a 
preferred embodiment; 

Figure 28 is an overvfew diagram of the logic utilized for initial configuration in accordance with a preferred 
embodiment; 

Figure 29 is a display of video infomiation in accordance with a preferred embodiment; and 
Figure 30 illustrates an ICA utility in accordance with a preferred embodiment. 



DETAILED DESCRIPTION 

A preferred embodiment of a system in accordance with the present invention is preferably practiced in the context of a 
personal computer such as an IBM compatible personal computer. Apple Macintosh computer or UNIX based workstafion. A 
representative hardware environment is depicted in Figure 1. which illustrates a typical hardware configuration of a workstation in 
accordance with a preferred embodiment having a central processing unit 110. sudi as a miaoprocessor. and a number of ottier 
units interconnected via a system bus 112. The workstation shown in Figure 1 includes a Random Access Memory (RAM) 114, 
Read Only Memory (ROM) 1 16, an I/O adapter 118 for connecting peripheral devices such as disk storage units 120 to the bus 
112, a user interface adapter 122 for connecting a keyboard 124. a mouse 126. a speaker 128, a miaophone 132. and/or other 
user interface devfces" such as a touch screen (not shown) to the bus 112. communication adapter 134 for connecting the 
workstation to a communication network (e.g.. a data processing network) and a display adapter 1 36 for connecting the bus 1 12 
to a display device 138. The workstation typically has resident thereon an operating system such as the Microsoft Windows NT or 
Windows/95 Operating System (OS), the IBM OS/2 operating system, the MAC OS, or UNIX operating system. Those skilled in 
the art will appreciate that the present invention may also be implemented on platforms and operating systems other than those 
mentioned. 

A preferred embodiment is written using JAVA, C, and the C+^- language and utilizes object oriented progranming 
methodology. Object oriented programming (OOP) has become increasingly used to develop complex applications. As OOP 
moves toward the mainstream of software design and development, various software solutions require adaptation to make use of 
the benefits of OOP. A need exists for these principles of OOP to be applied to a messaging interface of an electronic messaging 
system such fliat a set of OOP classes and objects for the messaging interface can be provided. A simulation engine in 
accordance with a preferred embodiment is based on a Microsoft Visual Basic component developed to help design and test 
feedback in relation to a Microsoft Excel spreadsheet. These spreadsheet models are what simulate actual business functions 
and become a task that will be performed by a student The Simulation Engine accepts simulation inputs and calculates various 
outputs and notifies the system of the status of the simulation at a given time in order to obtain appropriate feedback. 

Relationship of Components 

The simulation model executes the business function that the student is learning and is therefore the center point of the 
application. An activity 'layer' allows the user to visually guide the simulation by passing inputs into the simulation engine and 
receiving an output from the simulation model. For example, if the student was woricing on an income statement activity, the net 
sales and cost of goods sold calculaUons are passed as inputs to the simulation model and the net inrame value is calculated 
and retrieved as an output. As calculations are passed to and retrieved from the simulation model, they are also passed to ttre 
Intelligent Coaching Agent (ICA). The ICA analyzes the Inputs and Outputs to the simulation model and generates feedback 
based on a set of rules. This feedback is received and displayed through the Visual Basic Architecture. 

Figure 2 is a block diagram of a system architecture in accordance with a preferred embodiment. The Presentation 
'layer" 210 is separate from the acUvity 'layer* 220 and communication is facilitated through a set of messages 230 that control 
the display specific content topics. A preferred embodiment enables knowledge workers 200 & 201 to acquire complex skills 
rapidly, reliably and consistently aaoss an organization to deliver rapid acquisition of complex skills. This result is achieved by 
placing individuals in a simulated business environment that "looks and feels" like real work, and challenging them to make 
decisions which support a business' strategic objectives uUlizing highly effective learning theory (e.g., goal based learning, learn 
by doing, failure based learning, etc.). and ttie latest in multimedia user interfaces, coupled with three powerful, integrated 



software components. The first of ttiese components is a software Solution Construction Aid (SCA) 230 consisting of a 
mattiematicai modeling tool 234 whidi simulates ljusiness outcomes of an individual's collective actions over a period of time. 
The second component is a knowledge system 250 consisting of an HTML content layer which organizes and presents packaged 
knowledge much like an online text book with practice exercises, video war stories, and a glossary. The third component is a 
software tutor 270 comprising an artificial intelligence engine 240 which generates individualized coaching messages based on 
decisions made by learner. 

Feedback is unique for each individual completing the course and supports client cultural messages 242 "designed 
into" the course. A business simulation methodology that includes support for content acquisition, story tine design, interaction 
design, feedback and coaching delivery, and content delivery is architected into the system in accordance with a preferred 
embodiment. A large number of "pre-designed" teaming interactions such as drag and drop association of information 238, 
situation assessment/action planning, interviewing (one-on-one, one-to-many), presenting {to a group of e)q3erts/executives}. 
metering of performance (handle now, handle later), "time jumping" for impact of decisions, competitive landscape shift (while 
"time jumping", competitors merge, customers are acquired, etc.) and video interviewing with automated note taking are also 
included in accordance with a prefeaed embodiment. 

Business simulation in accordance with a preferred embodiment delivers training curricula in an optimal manner. This 
is because such applications provide effective training that mirrors a student's actual work environment. The application of skills 
"on the job" fadlitates inaeased retention and higher overall job perfomiance. While the results of such training applications are 
impressive, business simulations are very complex to design and build correctly. These simulations are characterized by a very 
open-ended environment, where students can go through the application along any number of paths, depending on their learning 
styie and prior experiences/knowledge. 

A category of learning approaches called Learn by Doing, is commonly used as a solution to support the first phase 
(Learn) of the Workforce Performance Cycle. However, it can also be a solution to support the second phase (Perform) of the 
cyde tc enable point of need learning during job performance. By adopting the approach presented, some of the benefits of a 
technology based approach for building business simulation solutions which create more repeatable, predictable prqects 
resulting in more perceived and actual user value at a lower cost and in less time are highlighted. 

Most corporate training programs today are misdirected because Ihey have failed to focus property on the purpose of 
their training. These programs have confused the memorization of facts with the ability to perform tasks; the knowing of "that" 
with the knowing of "how". By adopting the methods of traditional schools, businesses are teaching a wide breadth of 
disconnected, decontextualized facts and figures, when they should be focused on improved performance. How do you teach 
perfomiance. when lectures, books, and tests inherently are designed around facts and figures? Throw away the lectures, 
books, and tests. The best way to prepare for high performance is to perform; experience is the best teacher! Most business 
leaders agree that workers become more effective the more time they spend in their jobs. The best approach for training novice 
employees, therefore, would be letting them learn on the job, acquiring skills in their actual work environment. The idea of 
leaming-by-doing is not revolutionary, yet it is resisted in business and academia. Why is this so, if higher competence is 
universally desired? 

Learners are reluctant to adopt leaming-by-doing because they are frightened of failure. People work hard to avoid 
making mistakes in front of others. Business leaders are hesitant to implement leaming-by-doing because novice failure may 
have dramatic safely, legal and financial implications. Imagine a novice pilot leaming-by-doing as he accelerates a large |et plane 



down a runway; likewise, consider a new financial analyst leaming-by-doing as he structures a multi-million dollar financial loan. 
Few employers are willing to endure such falures to have a more competent workforce. 

The key to such a support system is that it is seamlessly integrated into the business system that the knowledge 
worker uses to execute their job tasks. Workers don't need to go "off-One" or seek out cryptic information buried within paper 
manuals and binders for guidance or to find the answer to queries. All the support components are made available through the 
same applications the worker's use, at the point in which they need them, taitored to the individual to show -how", not just "whar. 
Learning would be occurring ail the time, with little distinction between perfomiing and improving performance. Establishing that 
training should focus on perfomiance (how), rather than facts (what), and extending the model of learning to include assistance 
while performing, rather than only before performance, still leaves us dangerously exposed in preparing to compete in the new, 
chaotic economy. As was mentioned in the opening of this paper, the pace of change in business today is whiplash fast. Not only 
are new methods of doing business evolving every 18-24 months, new competitors emerge, dominate, and fade in time periods 
businesses used to take to perform demographk; studies. (Mow more than ever, those who do not reinvent themselves on a 
regular basis will be fossilized by the pace of change. A typical BusSim engagement takes between one and two years to 
complete and requires a variety of both funcUonal and technical skills. Figure 3 depicts the timeline and relative resource 
requirements for each phase of development for a typical application development in accordance with a preferred embodiment 
The chart cleariy depicts the relationship between the large number of technical resources required for both the build and test 
phases of development. This is because the traditional development process used to build BusSim solutions reflects more of a 
"one or philosophy, where development is done from saatch in a monolithic fashion, with little or no reuse from one application 
to the next. This lack of reuse makes this approach prohibiflvely expensive, as well as lengthy, for future BusSim projects. 

The solution io this problem is to put tools in the hands of instructional designers that allows them to aeate their 
BusSim designs and implement them without the need for programmers to write code. And to put applicahon architectures that 
integrate with the tools in the hands of developers, providing them with the ability to quickly deliver solutions for a number of 
different platforms. The reuse, then, comes in using the tools and architectures from one engagement to another. Both functional 
and technical resources carry with them the knowledge of how to use Ihe technology, which also has an associated benefit of 
establishing a best-practice development methodology for BusSim engagements. 

Development Cycle Actwities 
In the Design Phase, instructional designers become oriented to the content area and begin to conceptualize an 
instructional approach. They familiarize themselves with the subject matter through reading materials and interviews with Subject 
Matter Experts (SMEs). They also idenfify learning objectives from key client contacts. Conceptual designs for student 
interactions and interface layouts also begin to emerge. After the conceptual designs have taken shape, Low-Fi user testing 
(a.k.a. Conference Room Piloting) is performed. Students interact with interface mock-ups while facilitators observe and record 
any issues. Finally, detailed designs are aeated that incorporate findings. Tliese detailed designs are hdnded off to the 
development team for implementation. The design phase has traditionally been fraught with several problems. Unlike a traditional 
business system, BusSim solutions are not rooted in tangible business processes, so requirements are difficult to identify in a 
concrete way. This leaves instructional designers with a 'blue sky design problem. With few business-driven constraints on the 
solution, shallow expertise in the content area, and limited technical skills, instructional designers have little help in beginning a 
design. Typically, only experienced designers have been able to conjure interface, analysis, and feedback designs that meet tiie 
learning objectives yet remain technically feasible to implement. To compound the problem. BusSim solutions are very open 
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ended in nature. The designer must anticipate a huge combination of student behamr to design feedback that is helpful and 
realistic. 

During the build phase, the application development team uses the detailed designs to code the application. Coding 
tasks include the interfaces and widgets that the student interacts with. The interfaces can be made up of buttons, grids, check 
boxes, or any other saeen controls that allow the student to view and manipulate his deliverables. The developer must also code 
logic that analyzes the student's work and provides feedback interactions. These interactions may take the form of text and/or 
multimedia feedback from simulated team members, conversations with simulated team members, or direct manipulations of the 
student's work by simulated team members. In parallel with these coding efforts, graphics, videos, and audio are being created 
for use in the application. Managing the development of these assets have their own complications. Risks in the build phase 
include misinterpretation of the designs. If the developer does not accurately understand the designer's intentions, the application 
will not function as desired. Also, coding these applications requires very skilled developers because the logic that analyzes the 
student's wori< and composes feedback is very complex. 

The Test Phase, as the name implies, is for testing the application. Testing is performed to verify the application m 
three ways: first that the application functions properly (functional testing), second that the students understand tfie interface and 
can navigate effectively (usability testing), and third that the learning objectives are met (cognition testing). Functional testing of 
the application can be carried out by the development team or by a dedicated test team. If the application fails to function 
properly, it is debugged, fixed, recompiled and retested until its operation is satisfactory Usability and cognition testing can only 
be carried out by test students who are unfamiliar with the application. If usability is unsatisfactory, parts of the interface and or 
feedback logic may need to be redesigned, recoded. and retested. If the learning objectives are not met, large parts of the 
application may need to be removed and completely redeveloped from a different perspective. The test phase is typicaUy where 
most of the difficulties in the BusSim development cycle are encountered. The process of discovenng and fixing functional, 
usability, and cognition problems is a difficult process and not an exact science. 

For functional testing, testers operate the application, either by following a test saipt or by acting spontaneously and 
documenting their actions as they go. When a problem or unexpected result is encountered, it too is documented. The 
application developer responsible for that part of the application then receives the documentation and attempts to duplicate the 
problem by repeating the tester's actions. When the problem is duplicated, the developer investigates further to find the cause 
and implement a fix. The developer once again repeats the tester's actions to verify that the fix solved the problem. Finally, all 
other test scripts must be rerun to verify that the fix did not have unintended consequences elsewhere in the application.The 
Execution Phase refers to the steady state operation of the completed application in its production environment. For some 
< lients this involves phone support for students. Clients may also want the ability to track students' progress and control their 
progression through the course. Lastly, clients may want the ability to track issues so they may be considered for inclusion in 
course maintenance releases. 

One of the key values of on-line courses is that they can be taken at a time, location, and pace that is convenient for 
the indivi-dual student. However, because students are not centrally located, support is not always readily available. For this 
reason it is often desirable to have phone support for students. Clients may also desire to track students' progress, or control 
their advancement through the course. Under this strategy, after a student completes a section of the course, he will transfer his 
progress data to a processing center either electronically or by physically mailing a disk. There it can be analyzed to verify that 
he completed all required work satisfactorily. One difficulty commonly associated with student tracking is isolating the student 



data for analysisJt can be unwialdyto transmit all the course data, so it is often imper^^^^ 
to perform tlie necessary analysis of ttie studenrs progress. 

A Delivery Framework for Business Simulation 
As discussed earlier, the traditional development process used to build BusSim solutions reflects more of a "one oft" 
philosophy, where development is done from saatchinamonolithic fashion, with little or no reuse from one appM^ 
next. A better approach would be. to focus on reducing the total effort required for development through reuse, which in turn 

wouWdeaease cost and devetopmenttlme. The first step in considering reuse as an option is the idenftficafion of 
aspects of the different BusSim applications that can be generalized to be useful in future application^ 
elements that make up these applications, three common aspects emerge as integral parts of each: interface, Anal^^^^ 
interpretation. Every BusSim application must have a mechanism for interaction with the student. The degree of complexity of 

each mterface may vary.from the high interactivity ofahigh-fidelityreal^me Simulation task, to the less comply 

delivery requirements ofabusiness case background information task. Regardless of how sophisticated the User interface^ 
It IS a vital piece of making the underlying simulation and feedback logic useful to the end user. 

Every BusSim application does analysis on the data that defmes the current state of the simulation many times 
throughout theexecution of the application. This analysis is doneeithertodeterminewhatishappening in the Simulation orto 
perform addiBonal calculations on thedata which are then fed back into the Simulation. For example, the analyst ^ 
recogniton of any actons the student has taken on artifacts within the simulated environment (notebooks number values 

mterv.ewsconducted,etc.),oritmaybethecalculafionofanROIbasedonnumbersthestudenthassupplied. Substantive 
usey feedback isaaitical piece of any BusSim application, it is the main mechanism to communicate if actions taken by the 
student are helping or hurting them meet their perfomiance objectives. The interpretafon piece of the set of proposed 
commonalties takes the results of any analysis perfom,ed and makes sense of it. It takes the non-biased view of the woridt^^^ 
the Analysis portion delivers (i.e., "Demand is up 3%") and Places some evaluative context around it (i.e.,"Deman 
expected 7%; you're in trouble!", or "Demand has exceeded projections of 1.5%; Great job!"). 

There are several approaches to capturing commonalties for reuse. Two of the more common approaches are 
framework-based and component-based. To help illustrate the differences between the m approaches, we will draw an analogy 
between building an application and building a house. One can construct a house from scratch, using the raw materials Ms 
nails, paint, concrete, etc. One can also construct an application from scratch, using theraw materials of newdesigns and new 
codaTheeffortinvolvedinbothundertakingscanbereducedthroughframework-basedand/orcomponent-basedreuse Within 
the paradigm of framework-based reuse.agenenc framework or architectureis constructed that contains commonalties In 
house analogy, one could purchase a prefabricated house framework consisting of fkwrs. outside walls, bean^ 
The house can be customized by adding partition walls, wall-pape, woodwork, carpeting etc. Similarly,pre 
frameworks are available that contain baseline application structure and functionality. Individual applications are completed by 
adding spedfic functionality and customizing the look-and-feel. An example of a commonly used appli^^^^ 
MK^osoft Foundation Classes. It is a framework for developing Windows applications using C... MFC supplies the base 
functionality ofawindowing application and the devdoper completes theapplication by adding 
Framework-based reuse is best suited for capturing temp/afa-fcfeatures.for example user interface management proc^^^ 
object behaviors, and any other features that may require specialization. Some benefits of using a framework include: 

Extensive functionality can be incorporated into a framework. In the house analogy, if I know I am going to build a 
whole neighborhood of three bedroom ranches. I can build the plumbing, ^ring. and partition walls right into the framework 



reducing the inaemental effort required for each houseJflknowlamgoingtobuildalarge number 
they will have more commonalties that can be included in the framework rather than built individually. 

Applicationscanoverridetheframework-suppliedfunctionaiitywhereverappropriate.lfahouseframework 
came w,thpre-painted walls, the builder could just paint over them with preferred a)Iors.Sir,«l^^^^ 
mhentance allows an application developer to override the behavior of the framework. In the paradigm of component-^^^^ 
reuse, key functionality is encapsulated in a component. The component can then be reused in mulfiple applications In the 
house anatogy, components correspond to appliances such as dishwashers, refrigerators, microwaves, etc. Similarly many 
application components with pre-packaged functionality are available from a variety of vendors. An example of a popular 
component is a Data Grid. It is a component that can be integrated into an application to deliver the capability of viewing 
cdumnar data in a spreadsheet-like grid. Component-based reuse is best suited for capturing black^ox-like features, for 
example text processing, data manipulation, or any other features that do not require spedalizaiion. 

Several applications on the same computer can share a single component. This is not such a good fit with the 
analogy.but imagine if all the houses inaneighborhood could share the same dishwasher simultaneously.Each home wouW 
have to supply its own dishes, detergent, and water, but they could all wash dishes in parallel. In the application component 
worid. th,s type of sharing is easily accomplished and results in reduced disk and memory requirements. 

Components tend to be less platform and tool dependent. A microwave can be used in virtually any house 

whether ifsframework is steel or wood, and regardless of Whether itwas customized for building mansions or shacks You can 
put a h,gh-end miaowave in a low^nd house and ^ce-versa. You can even have multiple different microwaves in your house 
Component technologies such as CORBA. COM, and Java Beans make this kind of flexibility commonplace in application 
development. Often, the best answer to achieving reuse is through a combination of framework-based and component-based 
techniques. A framework-based approach for buikting BusSim ap^ications is appropriate for developing the user interface 
handling user and system events, starting and stopping the application, and other application-spedfic and delivery platfom,- 
speafic functions. A component-based approach is appropriate for black-box functionality. That is, functionality that 
as-,s with no specialization required. In creating architectures to support BusSim application development, it is imperative that 
any assets remain as flexible and extensible as possible or reusability may be diminished. Therefore, we chose to implement ihe 
unique aspects of BusSim applicatfons using a component approach rather than a framework approach. This decision is further 
supported by the following observations. 

Delivery Framework for Business Simulation 

Components are combined with an Application Framework and an Application Architecture to achieve maximum reuse 

and minimum custom development effort The Application Architecture is added to provide communication support between the 

application interface and the components, and between the components. This solution has the following features' The 

components (identified by the icons) encapsulate key BusSim functionality. The Application Architecture provides th 

allows application-to-component and component-to-component communication. The ApplicationFrameworkprovid^^ 

and base functionality that can be customized for different interaction styles. Onlythe application interface mustbe custom 
developed. The next section discusses each of these components in further detail. 

The Business Simulation Toolset 

We have clearly defined why a combined component*amework approach is the best solution for delivering high- 

quality BusSim solutions atalower cost. Given that there areanumber of third party frameworics already on the marketthat 
provide delivery capability for a wide variety of platforms, the TEL project is focused on defining and developing a set o' 



components that provide unique services for the development and delivery of BusSim solutions. These components along with a 
set of design and test workbenches are the tools used by instructional designers to support activities in the four phases of 
BusSim development We caM this suite of tools the Business Simulation Toolset. Following is a description of each of the 
components and workbenches of the toolset. A Component can be thought of as a black box that encapsulates the behavior 
and data necessary to support a related set of services. It exposes these services to the outside world through published 
interfaces. The published interface of a component allows you to understand what it does through the services it offers, but not 
how it does it. The complexity of its implementation is hidden from the user. The following are the key components of the BusSim 
Toolset. Domain Component - provides services for modeling the state of a simulation. Profiling Component - provides services 
for rule-based evaluating the state of a simuiafion. Transformation Component - provides services for manipulating the state of a 

Remediation Component - provides services for tfie rule-based delivering of feedback to the student The Domain 
Model component is the central component of the suite that facilitates communication of context data across the application and 
the other components. It is a modeling tool that can use industry-standard database such as Informix, Oracle, or Sybase to store 
its data. A domain model is a representation of the objects in a simulation. The objects are such pseudo tangible things as a 
lever the student can pull, a form or notepad the student fills out. a character the student interacts with in a simulated meeting, 
etc. They can also be abstract objects such as the ROI for a particular investment, the number of times the student asked a 
particular question, etc. These objects are called entities. Some example entities include: Vehicles, operators and incidents in 
an insurance domain; Journal entries, cash flow statements and balance sheets in a finandal accounting domain and Consumers 
and purdiases in a marketing domain. 

An entity can also contan other entities. For example, a personal bank account entity might contain an entity that 
represents a savings account. Every enUty has a set of properties where each property in some way describes the entity; The 
set of properties owned by an entity, in essence, define the entity. Some example properties include: An incident entity on an 
insurance application owns properties such as "Occurrence Date", Inddent Type Code", etc. A journal entry owns properties 
such as -Credit Account". "Debit Account", and "Amount"; and a revolving credit account entity on a mortgage application owns 
properties such as "Outstanding Balance", "Available Limit", etc. Figure 4 llustrates a small segment of a domain model for daims 
handlers in the auto insurance industry in accordance with a preferred embodiment. 

Profiling Component 

In the simplest terms, the purpose of the Profiling Component is to analyze the current state of a domain and identify 
spedfic things that are tnje about that domain. This infomaBon is then passed to the Remediation Component which provides 
feedbadc to the student The Profiling Component analyzes the domain by asking questions about the domain's state, akin to an 
investigafor asking questions about a case. The questions that the Profiler asks are called profiles. For example, suppose there 
is a task about building a campfire and the student has just thrown a match on a pile of wood, but the fire didn't start. In order to 
give useful feedback to the student, a tutor would need to know things like: was the match lit?, was the wood wet?, was there 
kindling in the pile?, etc. These quesUons would be among the profiles that the Profiling Component wouW use to analyze the 
domain. The results of the analysis would then be passed off to the Remediation Component whidi would use this information to 
provide spedfic feedbadc to the student Spedfically. a profile is a set of criteria that is matched against the domain. The 
purpose of a profile is to check whether the criteria defined by the profile is met in the domain. Using a visual editing tool, 
instructional designers create profiles to identify those things that are important to know about the domain for a given task. 
During execution of a BusSim applicafion at the point that feedback is requested either by the student or pro-adively by the 
application, the set of profiles associated with the current task are evaluated to determine which ones are true. Example profiles 



include: Good productions strategy but wrong Break-Even Formula; Good driving record and low daims history; and Correct 
Cash Flow Analysis but poor Return on Investment (ROIj 

A profile is composed of two types of structures: characteristics and collective characteristics. A characteristic is a 
conditional (the /f half of a rule) that identifies a subset of the domain that is important for determining what feedback to deliver to 
the student. Example characteristics include; Wrong debit account in transaction 1 ; Perfect cost classification; At Least 1 OUI in 
the last 3 years; More than $4000 in claims in the last 2 years; and More than two at-fault accidents in 5 years 
A characteristic's conditional uses one or more atomics as the operands to identify the subset of the domain that defines the 
charaderistk:. An atomic only makes reference to a single property of a single entity in the domain; thus the term atomic. 
Example atomics include: The number of DUfs >= 1; ROI > 10%; and Income between $75,000 and $1 10,000. A collective 
characteristic is a conditional that uses multiple characteristics and/or other collecbve characteristics as its operands. Collective 
characteristics allow instructional designers to build richer expressions (i.e.. ask more complex questions). Example collective 
characteristics include: Bad Household driving record; Good Credit Rating; Marginal Credit Rating; Problems with Cash for 
Expense transactions; and Problems with Sources and uses of cash. Once aeated. designers are able to reuse these elements 
within multiple expressions, which significantly eases the burden of creating additional profiles. When building a profile from its 
elements, atomics can be used by multiple characteristics, characteristics can be used by multiple collective characteristics and 
profiles, and collective characteristics can be used by multiple collective characteristics and profiles. Figure 5 illustrates an 
insurance underwriting profile in accordance with a preferred embodiment. 

Example Profile for Insurance Underwriting 

Transformation Component - Whereas the Profiling Component asks questions about the domain, the 
Transformation Component performs calculations on the domain and feeds the results back into the domain for further analysis 
by the Profiting Component. This facilitates the modeling of complex business systems that would otherwise be very difficult to 
implement as part of the application. Within the Analysis phase of the Interface/Analysis/lnterpretation execution flow, the 
Transformation Component actually acts on the domain before tiie Profiling Component does its analysis. The Transfomiation 
Component acts as a shell that wraps one or more data modeling components for the purpose of integrating these components 
into a BusSim application. The Transformation Component facilitates the transfer of specific data from the domain to the data 
modeling component (inputs) for calculations to be performed on the data, as well as the transfer of the results of the calculations 
from the data modeling component back to the domain (outputs). Figure 6 illustrates a transformation component in accordance 
with a preferred embodiment. The data modeling components could be third party modeOng environments such as spreadsheet- 
based modeling (e.g.. Excel, Formulal) or discrete time-based simulation modeling (e.g., PowerSim. VenSim). The components 
could also be custom built in C++ VS. Access, or any tool that is ODBC compliant to provide unique modeling environments. 
Using the Transformation Component to wrap a third party spreadsheet component provides an easy way of integrating into an 
application spreadsheet-based data analysis, created by such tools as Excel. The Transformation Component provides a shell 
for the spreadsheet so Uiat it can look into the domain, pull out values needed as inputs, perfomis its calculations, and post 
outputs back to the domain. 

For example, if the financial statements of a company are stored in the domain, the domain would hold the baseline 
data like how much cash the company has. what its assets and liabilities are. etc. The Transformation Component would be able 
to look at the data and calculate additional values like cash flow ratios, ROI or NPV of investments, or any other calculations to 
quantitatively analyze the financial health of the company. Depending on their complexity, these calculations could be performed 
by pre-existing spreadsheets Uiat a client has already spent considerable time developing. 



Remediation Component - The Remediation Component is an expert system tfiat facilitates integration of inteiiigent 
feedback into BusSim applications. It has the following features: Ability to compose high quaHty text feedbadt; Ability to compose 
multimedia feedback that includes video and/or audio; Ability to include reference material in feedback such as Authorware 
pages or Web Pages and AMity to acfively manipulate the users deliverables to highlight or even fix users' errors. A proven 
remediation theory embedded in its feedback composition algorithm atows integration of digital assets into the Remediation of a 
training or IPS application. The Remediation model consists of three primary objects: Concepts; Coach Topics and Coach Items. 
Concepts are objects that represent real-world concepts that the user will be faced with in the interface. Concepts can be broken 
into sutK»ncepts, creating a hierarchical tree of concepts. This tree can be arbitrarily deep and wide to support rich concept 
modeling. Concepts can also own an arbitrary number of Coach Topics. Coach Topics are objects that represent a discussion 
topic that may be appropriate for a concept. Coach Topics can own an arbitrary number of Coach Items. Coach Items are items 
of feedback that may indude text, audio, video. URL's, or updates to the Domain Model. Coadi Items are owned by Coadi 
Topics and are assembled by the Remediation Component algorithm. 

Workbenches- The BusSm Toolset also indudes a set of workbenches that are used by instructional designers to 
design and build BusSim applicaUons. A workbench is a tool that fadlitates visual editing or testing of the data that the BusSim 
Components use for determining an applicatfon's run-time behavior. The BusSim Toolset indudes the following wori<bendies: 
Knowledge Workbench - The Knowledge Workbendi is a tool for the creation of domain, analysis and feedback data that is 
used by the BusSim Components. It has the following features: Allows the designer to 'paint' knowledge in a drag-and-drop 
interface; Knowledge is represented visually for easy communicaUon among designers; The interface is intelligent, altowing 
designers to only paint valid interactions; Designer's Task creations are stored in a central repository; The workbench supports 
ch3d(-in / diedt-out for exdusive editing of a task; Supports LAN-based or unlethered editing; Automatically generates 
documentation of the designs; and it Generates the data files that drive the behavior of the components. Simulated Student 
Test Workbench- The Simulated Student Test Workbench is a tool for the creation of data that simulates student's actions for 
testing BusSim Component behaviors. It has the following features: The Test Bendi generates a simulated application interface 
based on the Domain Model; The designer manipulates the objeds in the Domain Model to simulate student activity; The 
designer can invoke the components to experience the interadions the student will experience in production; and The designer 
can fully test the interaction behavior prior to development of the application interface Regression Test Workbench - The 
Regression Test Workbendi is a tool for replaj^ng and testing of student sessions to aid debugging. It has the following features: 
Eadi student submission can be individually replayed through the components; An arbitrary number of student submissions from 
the same session can be replayed in succession; Entire student sessions can be replayed in batdi instanOy; The interaction 
results of the student are juxtaposed with the results of the regression test for comparison. 

Development Cycle Activities 

The design phase of a BusSim application is streamlined by the use of the Knowledge Woricbench. The Knowledge 
Workbench is a visual editor for configuring the objects of the component engines to control their runtime behavior. The 
components are based on proven algorithms that capture and implement best practices and provide a conceptual framework and 
methodology for instructional design. In conceptual design, the wort^bench aitows the designer to paint a model of the hierarchy 
of Concepts that the student will need to master in the activity. This helps the designer organize the content in a logical way. The 
visual representation of ttie Concepts helps to communicate Weas to other designers for review. The consistent look and feel of 
the wori<bendi also contributes to a streamlined Quality Assurance process. In addition, standard documentation can be 
automafically generated for the entire design. As the design phase progresses, the designer adds more detail to the design of the 



Concept hierardiy by painting in Coach Topics that the student may need feedback on. The designer can associate multiple 
feedback topics with each Concept. The designer also characterizes each topic as being Praise, Polish. Focus, Redirect or one 
of several other types of feedback that are consistent with a proven remediation methodology. The designer can then fill each 
topic with text, video mr stories. Web page links. Authonware links, or any other media object that can be delivered to the 
student as part of the feedback topic. 

The toolset greatly reduces effort during functionality testing. The key driver of the effort reduction is that ttie 
components can automatically track the actions of the tester w^ittiout the need to add code support in the application. Whenever 
the tester takes an action in the interface, it is reported to ttie domain model. From there it can be tracked in a database. Testers 
no kjnger need to write down their actions for use in debugging; they are automatically written to disk. There is also a feature for 
attaching comments to a tester's actions. When unexpected behavior is encountered, the tester can hit a control key sequence 
that pops up a dialog to record a description of the errant behavtor. During the Execution Phase, ttie components are deployed to 
ttie studenrs platfomi. They provide simulated team member and feedbadc functionality with sub-second response time aid 
error-free operation. If the client desires it, stijdenl fracking mechanisms can be deployed at runtime for evaluation and 
adminisb-ation of students. This also enables the isolation of any defects that may have made it to production. 

Scenarios for Using the Business Simulation Toolset 
A good way to gain a better appreciation for how ttie BusSim Toolset can vastly improve the BusSim development 
effort is to walk through scenarios of how the tools would be used throughout Uie development lifecyde of a particular task in a 
BusSim application. For this purpose, we'll assume that the goal of the student in a specific task is to journalize invoice 
transactions, and that Uiis task is within ttie broader context of learning the fundamentals of financial accounting. A cursory 
descripiicn of the task from the student's perspective will help set the context for Uie scenarios. Following the description are five 
scenarios which describe various actiwties in the development of this task. The figure betow shows a screen shot of the task 
interface. Figure 7 illustrates the use of a toolbar to navigate and access application level feahires in accordance with a 
preferred embodiment. A student uses a toolbar to navigate and also to access some of ttie application-level features of the 
application. The toolbar is the inverted L-shaped object aaoss the fop and teft of ttie interface. The top section of the todbar 
allows the user to navigate to tasks wittiin the current activity. The left section of the toolbar allows Uie shident to access ottier 
feahjres of the application, including feedback. The student can have his deliverabtes analyzed and receive feedback by clicking 
on the Team button. 

In ttiis task, ttie student must journalize twenty-h«o invoices and ottier source documents to record ttie flow of budget 
dollars between internal accounts. {Note: 'Journalizing", or "Journalization", is the process of recording journal entiies in a 
general ledger from invoices or ottier source documents during an accounting period. The process entails aeating debit and 
balancing credit entries for each document. At the completion of ttiis process, ttie general ledger records are used to create a 
trial balance and subsequent financial reports.) In accordance with a preferred embodiment, an Intelligent Coaching Agent Tool 
(ICAT) was devetoped to standardize and simplify the aeation and delivery of feedback in a highly complex and open-ended 
environment. Feedback from a coach or hjtor is instrumental in guiding the teamer ttirough an applfcation. Moreover, by 
diagnosing trouble areas and recommending specific actions based on predicted student understanding of ttie domain stiident 
comprehension of key concepts is inaeased. By writing rules and feedback ttiaf correspond to a proven feedback strategy, 
consistent feedback is delivered throughout the application, regardless of the interaction type or of the spedfic 
designer/developer creating Uie feedback. The ICAT is packaged with a user-friendly workbench, so that it may be reused to 
increase productivity on projects requiring a similar rule-based data engine and repository. 



Darmition oflCATIn Accordance with a Preferred Embodiment 

The Intelligent Coaching Agent Tool (ICAT) is a suite of toofs-a database and a Dynamic Link Ubrary (DLL) njn-time 
engine - used by designers to create and execute just-in-time feedback of Goal Based training. Designers write feedback and 
rules in the development tools. Once the feedback is set. the run-time engine monitors user actions, fires rules and composes 
feedback whicii describes the business deliverable. The remediation model used within ICAT dynamicafly composes the most 
appropriate feedback to deliver to a student based on student's previous responses. The ICAT model is based on a theory of 
feedback which has been proven effective by pilot results and infomial interviews. The model is embodied in the object model 
and algorithms of the ICAT. Because the model is built into the tools, ail feedback created with the tool will conform to the model. 
ICAT plays two roles in student training. First, the (CAT is a leaching system, helping students to fully comprehend and apply 
information. Second, ICAT is a gatekeeper, ensuring that each student has mastered the material before moving on to addittonal 
infomiation. ICAT is a self contained module, separate from the applKation. Separating the ICAT from the application allows 
other projects to use the ICAT and allows designers to test feedback before the application is complete. The ICAT Module is built 
on six processes which altow a student to interact effectively with the interface to compose and deliver the appropriate feedback 
for a student's mistakes. ICAT development methodology is a seven step methodology for creating feedback. The methodology 
contains specific steps, general guidelines and lessons teamed from the field. Using the methodology inaeases the effectiveness 
of the feedback to meet the educational requirements of the course. The processes each contain a knowledge model and some 
contain algorithms. Each process has specific knowledge architected into its design to enhance remediation and teaching. There 
is a suite of testing tools for the ICAT. These tools allow designers and developers test all of their feedback and rules. In addition, 
the utilities lei designers capture real time activities of students as they go through the course. The tools and run-time engine in 
accordance with a preferred embodiment include expert knowledge of remediation. These objects include togic that analyzes a 
student's wori< to identify problem areas and deliver focused feedback. The designers need only instantiate the objects to put the 
fools to work. Embodying expert knowledge in the tools and engine ensures that each section of a course has the same effective 
feedback structure in place. A file structure in accordance with a preferred embodiment provides a standard system environment 
for all applications in accordance with a preferred embodiment. A development directory holds a plurality of sub-directories. The 
content in the documentation directory is part of a separate installation from the architecture. This is due to the size of the 
documentation directory. It does not require any support files, thus it may be placed on a IAN or on individual computers. When 
the architecture is installed in accordance with a preferred embodiment, the development directory has an _Arch, _Tools. 
_Utilities. Documentafion. QED, and XDefault development directory. Each folder has its own directory structure that is inter- 
linked with the other directories. This structure must be maintained to assure consistency and compatibility between prqects to 
clarify project differences, and architecture updates. 

The _Arch directory stores many of the most common parts of the system architecture. These files generally do not 
change and can be reused in any area of the project If there is common visual basic code for applications that will continuously 
be used in other applfcations, the files will be housed in a fokler in this directory. The sub-directories in the _Arch directory are 
broken into certain objects of the main project Object in this case refers to parts of a project that are commonly referred to within 
the project. For example, modules and classes are defined here, and the directory is analogous to a library of functions. APIs, 
etc... that do not change. For example the IcaObj directory stores code for the Intelligent Coaching Agent (ICA). The InBoxObj 
directory stores code for the InBox part of the project and so on. The file stmcture uses some primary object references as file 
directories. For example, the IcaObj directory is a component that contains primary objects for the ICA such as functional forms, 
modules and classes. The BrowserObj directory contains modules, classes and forms related to thb browser functionality in the 



architecture. The HTMLGIossary directory contains code that is used for the HTML reference and gtossary component of the 
architecture. The IcaObj directory contains ICA functional code to be used in an application. This code is instantiated and 
enhanced in accordance with a preferred embodiment. The InBoxObj directory contains code pertaining to the inbox 
functionality used within the architecture. Specifically, there are two major components in this architecture directory. There is a 
new .OCX control that was created to provide functionality for an inbox in the application. Tfiere is also code that provides support 
for a legacy inbox application. The PracticeObj directory contains code for the topics component of the architecture. The topics 
component can be implemented with the HTMLGIossary component as well. The QmediaObjdiredorya^^^^^^^^ 
that are media related. An example is the QVIDcfrl.cls. The QViDctrl is the code that aeates the links between QVID files in an 
application and the system in accordance with a preferred embodiment. The SlmObj directory contains the Simulation Engine, a 
component of the application that notifies the tutor of inputs and outputs using a spreadsheet to facilitate communication. The 
StaticOb] directory holds any component that the application will use statically from the rest of the application. For example, the 
login form is kept in this foWer and is used as a static object in accordance with a preferred embodiment. The SysDynObj ' 
directon^ contains the code that allows the Systems Dynamics Engine (Powersim) to pass values to the Simulation Engine and 
return the values to the tutor. The VBObj directory contains common Visual Basic objects used in applications. For example the 
NowWhat, Visual Basic Reference forms, and specific message box components are stored in this folder. The _Tools directory 
contains two main directories. They represent the two most used tools in accordance with a preferred embodiment. The two 
directories provide the code for the tools themselves. The reason for providing the code for these tools is to allow a developer to 
enhance certain parts of the tools to extend their ability. This is important for the current project development and also for the 
growth of the tools. TTie Icautils directory contains a data, database, default, graphics, icadoc, and testdata directory. The 
purpose of ail of these directories is to provide a secondary working directory for a developer to keep their testing environment of 
enhanced Icautils applications separate from the project application. It is built as a testbed for the tool only. No application 
specific work should be done here. The purpose of each of these directories will be explained in more depth in the project 
directory section. The TestData folder is unique to the _Tools/lCAUt,ls directory. It contains test data for the regression bench 
among others components in tCAUtils. 

The Utilities directory holds the available utilities that a Business Simulation project requires for optimal results. This is 
a repository for code and executable utilities that developers and designers may utilize and enhance in accordance with a 
preferred embodiment Most of the uHlities are small applications or tools that can be used in the producfion of si 
comprise an executable and code to go with it for any enhancements or changes to the utility. If new utilities are aeated on a 
project or existing utiliUes are enhanced, it is important to notify the managers or developers in charge of keeping track of the 
Business Simulation assets. Any enhancements, changes or additions to the Business Simulation technology assets are 
important for future and existing projects. 

In the ICAT model of feedback, there are four levels of severity of error and four corresponding levels of feedback. The 
tutor goes through the student's work, identifies the severity of the error and then provides the corresponding level of feedback. 



Educational Categories of Feedback 


ERROR 


FEEDBACK 


Error j Descripti 


Feedbac j Description 
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Type 




kType 




None 


No errors 
exist. The student's 
work is perfect. 


Praise 


Confirmation that the student 
completed the task correctly. 
Example:Great. You have journalized 
all accounts correctly. 1 am happy to 
see you recognized we are paying for 
most of our bills 'on account". 


Syntacti 

c 


Tfiere may be 
spelling mistakes or 
other syntactic 
errors. As a 
designer, you 
should be confident 
that the student will 
have mastered the 
material at this 
point 


Polish 


Tells the student the 
specific actions he did incorrectly, 
and possibly correct them for him. 

Example- 
There are one or two errors 
in your work. It looks like you 
misclassified the purchase of the fax 
as a cash purchase when it is really a 
purchase on account. 


Local 


A 

paragraph of a 
paper is missing or 
the student has 
made a number of 
mistakes all in one 
area. The student 
clearly does not 
understand this - 
area. 


Focus 


Focus the student on this 
area of his work. Point out that he 
does not understand at least one 
major concept. 

Example: 

Looking over your work, 1 
see that you do not understand the 
concept of "on account". Why don't 
you review that concept and review 
your work for errors. 


Global 


The 

student has written 
on the wrong 
subject or there are 
mistakes all over the 
student's work 


Redirect 


Restate the goal of the 
activity and tell the student to review 
main concepts and retry the activity. 
"There are lots of mistakes 
throughout your work. You need to 
think atjout what type of transaction 
each source document represents 
tiefore journalizing it." 



error requiring redirect feedback. If the student returns with the paper rewritten, but with many errors in one area of the paper. 
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focus feedback is needed. With all of those errors fixed and only spelling mistakes-syntacfic mistakes-polish feedback is 
needed. When all syntactic mistakes were corrected, the tutor would return praise and restate why the student had written the 
correct paper. Focusing on the educational components of compleBng a task is not enough. As any teacher knows, student will 
often try and cheat their way through a task. Students may do no work and hope the teacher does not notice or the student may 
only do minor changes in hope of a hint or part of the answer. To accommodate these administrative functions, there are three 
additional administrative categories of feedback. The administrative and the educational categories of feedback account for every 
piece of feedback a designer can write and a student can receive. To provide a better understanding of how the feedback works 
together, an example is provided befow. 

Rgure 8 is a GBS display in accordance with a preferred embodiment. The upper right area of the screen shows the 
account list There are four types of accounts: Assets. Uabilities & Equity. Revenues, and Expenses. The user clicks on one of 
the tabs to show the accounts of the corresponding type. The student journalizes a transaction by dragging an account from the 
account list onto the journal entry Debits or Credits. The student then enters the dollar amounts to debit or aedit each account in 
the entry. In the interface, as in real life, the student can have multi-legged journal entries {i.e.. debiting or aediting multiple 
accounts).A Toolbar 1200 and the first transaction of this Task 1210 appear prominently on the display. The student can move 
fomrard and back through the stack of transactions. For each transaction, the student must identify which accounts to debit and 
which to aedit. When the student is done, he clicks the Team button. Figure 9 is a feedback display in accordance with a 
preferred embodiment The student may attempt to outsmart the system by submitting without doing anything. The ICAT system 
identifies that the student has not done a substantial amount of work and returns the administrative feedback depicted in Figure 
9. The feedback points out that nothing has been done, but it also states that if the student does some work, the tutor wiU focus 
on the -irst few journal entries. Figure 10 illustrates a journal entry simulation in accordance with a preferred embodiment. Figure 
11 illustrates a simulated Bell Phone Bill journal entry in accordance with a preferred embodiment. The journal entry is 
accomplished by debiting Utilities Expenses and Crediting Cash for $700 each. Figure 12 illustrates a feedback display in 
accordance with a preferred embodiment. After attempting to journalize the first three transacUons. the student submits his work 
and receives the feedback depicted in Figure 12. The feedback starts by focusing the student on the area of work being 
evaluated. The ICAT states that it is only kicking at the first three journal entnes. The feedback states that the first tv.o entries are 
completely wrong, but the third is close. If the student had made large mistakes on each of the first three transactions, then the 
tCAT may have given redirect feedback, thinking a global error occurred. The third bullet point also highlights how specific the 
feedback can become, identifying near misses. 

Design Scenario-This Scenario illustrates how the tools are used to support conceptual and detailed design of a 
BusSim applicafion. Figure 13 illustrates the steps of the first scenario in accordance with a preferred embodiment The designer 
has gathered requirements and determined that to support the client's learning objectives, a task is required that teaches 
journalization skills. The designer begins the design first by learning about journalization herself, and then by using the 
Knowledge Workbench to sketch a hierarchy of the concepts she want the student to learn. At the most general level, she 
creates a root concept of 'Journalization'. She refines this by defining sub-concepts of 'Cash related transactions'. 'Expense 
related Transactions', and 'Expense on account transacttons'. These are each further refined to whatever level of depth is 
required to support the quality of the learning and the fidelity of the simulation. The designer then designs the journalization 
interface. Since a great way to learn is by doing, she deddes that the student shouW be asked to Journalize a set of transacUons. 
She comes up with a set of twenty-two documents that typify those a finance professional might see on the job. They include the 
gamut of Asset Expense. Liability and Equity, and Revenue transactions. Also included are some documents that are not 



supposed to be entered in the journal. These 'Distracters' are induded because sometimes errant documents occur in real life. 
The designer then uses the Domain Model features in the Knowledge Workbench to paint a Journal. An entity is created in the 
Domain Model to represent each transaction and each source document. Based on the twenty-two documents that the designer 
chose, she can anticipate errors that the student might make. For these errors, she creates topics of feedback and populates 
them with text. She also creates topics of feedback to tell the student when they have succeeded. Feedback Topics are aeated 
to handle a variety of situations that the student may cause. 

The next step is to aeate profiles that the will trigger the topics in the concept tree (this task is not computational in 
nature, so the Transformation Component does not need to be configured) . A profile resolves to true when its condiUons are met 
by the student's work. Each profile that resolves to true triggers a topic. To do some preliminary testing on the design, the 
designer invokes the Student Simulator Test Workbench. The designer can manipulate the Domain Model as if she were the 
student working in the interface. She drags accounts around to different transactions, indicating how she would like them 
journalized. She also enters the dollar amounts that she wouW like to debit or aediteach account. She submits her actions to the 
component engines to see the feedback the student would get if he had perfomied the activity in the same way. All of this occurs 
in the test bench without an application interface. The last step in this phase is low-fi user testing. A test student interacts witti a 
PowerPoint sikJe or bitmap of the proposed application interface for the Joumalizatron Task. A facilitator mimics his actions in the 
test bench and tells him what the feedback would be. This simplifies low-fi user testing and helps the designer to identify usability 
issues earlier in the design when they are much cheaper to resolve. 

Figures 14 and 15 illustrate the steps associated with a build scenario in accordance with a preferred embodiment. 
The instructional designer completes the inifial interaction and interface designs as seen in the previous Scenario. After low-fi 
user testing, the Build Phase begins. Graphic artists use the designs to aeate the bitmaps that will make up the interface. These 
include bitmaps for the buttons, tabs, and transactions, as well as all the other screen widgets. The developer builds the interface 
using the bitmaps and adds the functionality that notifies the Domain Model of student actions. Standard event-driven 
programming techniques are used to create code that will react to events in the interface during application execution and pass 
the appropriate information to the Domain Model. The devetoper does not need to have any deep knowledge about the content 
because she does not have to build any logic to support analysis of the student actions or feedback. The developer also codes 
the logic to rebuild the interface based on changes to the domain model. A few passes through these steps will typically be 
required to get the application communicating correctly with the components. The debug utilities and Regression Test 
Workbench streamline the process. After the application interface and component communication are functioning as designed, 
the task is migrated to Usability testing. 

The Test Scenario demonstrates Bie cycle that the team goes through to test the application. It specifically addresses 
usability testing, but it is easy to see how the tools also benefit functional and cognition testing. Again, we will use the 
Journalization Task as an example. Figure 16 illustrates a test scenario in accordance with a preferred embodiment. The test 
students work through the journalization activity. One of the students has made it over half way through the task and has just 
attempted to journalize the sixteenth transaction. The student submits to the Financial Coach, but the feedback comes back 
blank. The student notifies the facilitator who right-clicks on the Financial Coach's face in the feedback window, A dialog pops up 
that shows this is the twenty-seventh submission and shows some other details about the submission. The facilitator (or even the 
student in recent efforts) enters a text description of the problem, and fills out some other fields to indicate the nature and 
severity of the problem. All the student's work and the feedback they got for the twenty-seven submissions is posted to the User 
Acceptance Test (UAT) archive database. The instructional designer can review all the student histories in the UAT database 



and retrieve the session where the student in question attempted the Journalization Task. The designer then reaeates the 
problem by replaying the student's twenty-seven submissions through the component engines using the Regression Test 
Workbench. The designer can then browse through each submission that the student made and view the work that the student 
did on the submission, the feedback the student got. and the facilitator commraits, if any. Now the designef can use the 
debugging tools to detemiine the source of the problem. In a few minutes, she is able to determine that additional profiles and 
topics are needed to address the specific combinations of mistakes the student made. She uses the Knowledge Workbench to 
design the new profiles and topics. She also adds a placeholder and a script for a video war story that supports the learning 
under these drcumstances. The designer saves the new design of the task and reruns the Regression Test Workbench on the 
student's session with the new task design. After she is satisfied that the new profiles, topics, and war stories are giving the 
desired coverage, she ships the new task design file to user testing and it's rolled out to afl of the users. 

Execution Scenario: Student Administration - Figure 17 illustrates how the tool suite supports student 
administraUon in accordance with a preferred embodiment. When a student first enters a course she perfomis a pre-testof his 
financial skills and fills out an inforaiation sheet about his job role, level, etc. This information is reported to the Domain Model. 
The Profiling Component analyzes the pre-test. information sheet, and any other data to detemiine the specific learning needs of 
this student A curriculum is dynamically configured from the Task Library for this student The application configures its main 
navigational interface {if the app has one) to indicate that this student needs to team Journalization, among other things. As the 
student progresses through the course, his performance indicates that his proficiency is growing more rapidly in some areas than 
in others. Based on this finding, his curriculum is altered to give him addiUonal Tasks that will help him master the content he is 
having trouble with. Also, Tasks may be removed where he has demonstrated proficiency. While the student is performing the 
work in the Tasks, every action he takes, the feedback he gets, and any other indicators of performance are tracked in the 
Student Tracking Database. Periodically, part or all of the tracked data are transmitted to a central location. The data can be 
used to verify that the student completed all of the woric, and it can be further analyzed to measure his degree of mastery of the 
content 

Execution Scenario: Student Interaction - Figure 18 illustrates a suite to support a student interaction in accordance 
with a preferred embodiment In this task the student is trying to journalize invoices. He sees a chart of accounts, an invoice, and 
the journal entry for each invoice. He journalizes a transaction by dragging and dropping an account from the chart of accounts 
onto the 'Debits' or the 'Credits' line of the journal entry and entering the dollar amount of the debit or credit He does this for 
each transaction. As the student interacts with the interface, all acUons are reported to and recorded in the Domain Model. The 
Domain Model has a meta-model describing a transaction, its data, and what infomiation a journal entry contains. The actions of 
the student populates the entities in the domain model with the appropriate infomiation. When the student is ready, he submits 
the work to a simulated team member for review. This submission triggers the Analysis-Interpretation cycle. The Transformation 
Component is invoked and perfomis additional calculations on the data in the Domain Model, perhaps determining that Debits 
and Credits are unbalanced for a given journal entry. The Profiling Component can then perform rule-based pattern matching on 
the Domain Model, examining both the student actions and results of any Transfomiation Component analysis. Some of the 
profiles fire as they identify the mistakes and correct answers the student has given. Any profiles that fire activate topics in the 
Remediation Component. Afler the Profiling Component completes, the Remediation Component is invoked. The remediation 
algorithm searches the acth/e topics in the tree of concepts to detemiine the best set of topics to deliver. This set may contain 
text video, audio. URU. even actions that manipulate the Domain Model. It is then assembled into prose-like paragraphs of text 
and media and presented to the student The text feedback helps the student localize his journalization errors and understand 



why they are wrong and what is needed to correct the mistakes. The student is presented with the opportunity to view a video 
war story about the tax and legal consequences that arise from incorrect journalization. He is also presented with links to the 
refere/ice materials that describe the fundamentals of journalization. The Analysis-Interpretation cyde ends when any coach 
items that result in updates to the Domain Model have been posted and the interface is redrawn to represent the new domain 
data, in this case, the designer chose to highlight with a red check the transactions that the student journalized incorrectly. 

The Functional Definition of the ICAT 

This section describes the feedback processes in accordance with a preferred embodiment For each process, there is 
a definition of the process and a high-level description of the knowledge model. This definition is intended to give the reader a 
baseline understanding of some of the key components/objects in the model, so that he can proceed with the remaining sections 
of this paper. Refer to the Detailed Components of the ICAT for a more detailed description of each of the components within 
each knowledge model. To gain a general understanding of the ICAT, read only the general descriptions. To understand the 
ICAT deeply, read this section and the detailed component section regarding knowledge models and algorithms. These 
processes and algorithms embody the feedback model in the ICAT. There are six main processes in the ICAT, described below 
and in more detail on the following pages. 

Figure 19 illustrates the remediation process in accordance with a preferred embodin>enL Remediation starts as 
students interact with the application's interface (process #1). As the student tries to complete the business deliverable, the 
application sends messages to the ICAT about each action taken (process #2). When the studait is done and submits work for 
review, the ICAT compares how the student completed the activity with how the designer stated the activity should be completed 
(this is called domain knowledge). From this comparison, the ICAT get a count of how many items are right, wrong or irrelevant 
(process #3). With the count complete, the ICAT tries to fire all rules (process #4). Any rules which fire activate a coach topic 
(process #5). The feedback algorithm selects pieces of feedback to show and composes them into coherent paragraphs of text 
(process #6). Finally, as part of creating feedback text paragraphs, the ICAT replaces all variables in the feedback with specifics 
from the student's work. This gives the feedback even more spedfidty, so that it is truly customized to each student's actions. 

Knowledge Model - Interface Obiects In any GBS Task, the student must manipulate controls on the applicaUon 
interface to complete the required deliverables. Figure 20 illustrates the objects for the journalization task in accordance with a 
preferred embodiment. The following abstract objects are used to model all the various types of interface interactions. A 
Sourceltem is an object the student uses to complete a task. In the journalization example, the student makes a debit and aedit 
for each transaction. The student has a finite set of accounts with which to respond for each transaction. Each account that 
appears in the interface has a corresponding Sourceltem object In other words, the items the student can manipulate to 
complete the task (account names} are called Sourceltems. A Source is an object that groups a set of Sourceltem objects 
together. Source objects have a One-To-Many relationship with Sourceltem objects. In the journalization example, there are four 
types of accounts; Assets, Liabilities and Equity, Revenues, and Expenses. Each Account is of one and only one of these types 
and thus appears only under the appropriate tab. For each of the Account type tabs, there is a corresponding Source Object A 
Target is a fixed place where students place Sourceltems to complete a task, in the journalization example, the student places 
accounts on two possible targets: debits and credits. The top two lines of the journal entry control are Debit targets and the 
bottom two lines are Credit targets. These two targets are specific to the twelfth transaction. A TargetPage is an object that 
groups a set of Target objects together. TargetPage objects have a One-To-Many relationship with Target objects 0ust like the 
Source to Sourceltem relationship). In the journalization example, there is one journal entry for each of the twenty-two 
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transactions. For each journal entry there is a corresponding TargetPage object that contans the Debits Target and Credits 
Target for that journal entry. 

As the student manipulates the application interface, each acfion is reported to the ICAT. In order to tell the ICAT what 
actions were taken, the application calls to a database and asks for a specific interface control's ID. When the application has the 
5 ID of the target control and the Sourceltenj control, the application notifies the ICAT about the Target to Sourceltem mapping. In 
other words, every time a student manipulates a source item and assodates it with a target (e.g., dragging an account name to a 
debit line in the journal), the user action is recorded as a mapping of the source item to Uie target. This mapping is called a 
UserSourceltemTarget. Figure 21 illustrates the mapping of a source item to a target item in accordance with a preferred 
embodiment. When the student is ready, he submits his work to one of the simulated team members by clicking on the team 

10 member's icon. When the ICAT receives the student's work, it calculates how much of the work is correct by concept Concepts 
in our journalization activity m\\ include Debits, Credits, Asset Accounts, etc. For each of these concepts, the ICAT will review all 
student actions and determine how many of the student actions were correct. In order for the ICAT to understand which targets 
on the interface are associated with each concept, the targets are bundled into target groups and prioritized in a hierarchy. Once 
all possible coach topics are activated, a feedback selection analyzes the active pieces of remediation within the concept 

1 5 hierarchy and selects the most appropriate for delivery. The selected pieces of feedback are ttien assembled into a cohesive 
paragraph of feedback and delivered to the student. Figure 23 illustrates a feedback selection in accordance with a preferred 
embodiment. After the ICAT has activated Coach Topics via Rule firings, the Feedback Selection Algorithm is used to determine 
the most appropriate set of Coachltems (specific pieces of feedback text associated vinth a CoadiTopic) to deliver. The Algorithm 
accomplishes this by analyzing the concept hierarchy (TargetGroup tree), the active CoachTopics, and the usage history of the 

20 Coachltems. Figure 24 is a flowchart of the feedback logic in accordance with a preferred embodiment. There are five main 

areas to the feedback logic which execute sequentially as listed betow. First, the algorithm looks through the target groups and 
looks for the top-most target group with an active coach topic in it. Second, the algorithm then looks to see if that top-most coach 
item is praise feedback. If it is praise feedback, then the student has correctly completed the business deliverable and the ICAT 
wilt stop and return that coadi item. Third, if the feedback is not Praise, then the ICAT will took to see if it is redirect, polish, 

25 mastermind or incomplete-slop. If it is any of these, then the algorithm will stop and return that feedback to the user. Fourth, if the 

feedback is focus, then the algorithm looks to the children target groups and groups any active feedback in these target groups 
with the focus group header. Fifth, once the feedback has been gathered, then the substitution language is run which replaces 
substitution variables with the proper names. Once the ICAT has chosen the pieces of feedback to return, the feedback pieces 
are assembled into a paragraph. With the paragraph assembled, the ICAT goes through and replaces all variables. There are 

30 specific variables for Sourceltems and Targets. Variables give feedback spedficity. TTie feedback can point out whidi wrong 

Sourceltems were placed on which Targets. It also provides hints by providing one or two Sourceltems which are mapped to the 
Targei. 

The Steps Involved in Creating Feedback in Accordance With A Preferred Embodiment 

The goal of feedback is to help a student complete a business deliverable. The tutor needs to identify which concepts 
35 the student understands and which he does not. The tutor needs to tell the student about his problems and help him understand 
the concepts. There are seven major steps involved in developing feedback for an application. First, creating a strategy — The 
designer defines what the student should know. Second, limit errors through interface — The designer determines if the interface 
will identify some low level mistakes. Third, CTeadng a target group hierarchy — The designer represents that knowledge in the 
tutor. Fourth, sequendng the target group hierarchy — The designer tells the tutor which concepts should be diagnosed first. 
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Fifth, writing feedback — The designer writes feedback which tells the student how he did and what to do next. Sixth, wrifing 
Levels of Feedback — The designer writes different levels of feedback in case the student makes the same mistake more than 
once. Seventh, writing rules — The designer defines patterns which fire the feedback. 

A feedback strategy is a loose set of questions which guide the designer as he creates rules and feedback. The 
5 strategy desaibes what the student should learn, how he will try and create the business deliverable and how an expert 

completes the deliverable. The goal of ttie applicafion shouW be for the student to transition from Hie novice model to the expert 
model. What should the student know after using the application? The first task a designer needs to complete is to define 
exactly what knowledge a student must learn by the end of the interaction. Should ttie student know specific pieces of 
knowledge, such as formulas? Or, should the student understand high level strategies and detailed business processes? This 

1 0 knowledge is the foundation of ttie feedback strategy. The tutor needs to identify if the student has used the knowledge correctly, 
or if there were mistakes. An example is the journal task. For te activity, students need to know the purpose of the journalizing 
activity, the specific accounts to debit/aedit, and how much to debit/credit. A student's debit/credit is not correct or incorrect in 
isolation, but con-ect and incorrect in connection with the dollars debited/credited. Because there are two different types of 
knowledge-accounts to debil/aedit and amounts to debit/aedit-Oie feedback needs to identify and provide appropriate 

15 feedback for both types of mistakes. 

How will a novice try and complete the task? Designers should start by defining how they believe a novice v^ll try and 
complete the task. Which areas are hard and which are easy for the student. This novice view is the mental model a student will 
bring to the task and the feedback should help the student move to an expert view. Designers should pay special attention to 
characteristic mistakes they believe the student will make. Designers will want to aeate specific feedback for these mistakes. An 

20 example is mixing up expense accounts in the journal activity. Because students may mix up some of these accounts, the 
designer may need to write special feedback to help clear up any confusion. 

How does an expert complete the task? This is the expert model of completing the task. The feedback should help 
students transition to this understanding of the domain. When creating feedback, a designer should incorporate key features of 
the expert model into the praise feedback he writes. When a student completes portion of the task, positive reinforcement should 

25 be provided which confirms to the student that he is doing the task correctly and can use the same process to complete the other 
tasks. These four questions are not an outline for aeating feedback, but they define what the feedback and the whole 
application needs to accomplish. The designer should make sure that the feedback evaluates all of the knowledge a student 
should learn. In addition, the feedback should be able to remediate any characteristic mistakes the designer feels the student will 
make. Finally, the designer should group feedback so that it returns feedback as if it were an expert. With these components 

30 kienfified, a designer is ready to start aeating target group hierarchies. Because there are positive and negative repercussions, 
designers need to select the when to remediate through the interface carefully. The criteria for making the decision is if the 
mistake is a low level data entry mistake or a high level intellectual mistake. If the mistake is a low level mistake, such as miss- 
typing data, it may be appropriate to remediate via the interface. If the designer deddes to have the interface point out the 
mistakes, it shouW look as if the system generated the message. System generated messages are mechanical checks, requiring 

35 no complex reasoning. In contrast, complex reasoning, such as v*y a student chose a certain type of account to aeditor debit 
should be remediated through the ICAT. 

System messages - it is very important that the student know what type of remediation he is going to get from each 
source of information. Interface based remediation should look and feel like system messages. They should use a ditferent 
interf^ace from the ICAT remediation and should have a different feel. In the journalization task described throughout this paper, 
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there is a system message which states "Credits do not equal debits." This message is delivered through a different interface 
and the blunt short sentence is unlike all other remediation. The motivation for this is that low level data entry mistakes do not 
show misunderstanding but instead sloppy work. Sloppy-work mistakes do not require a great deal of reasoning about why they 
occurred instead, they simply need to be identified. High-level reasoning mistakes, however, do require a great deal of reasoning 
about why they occurred, and the ICAT pro^des tools, such as target groups, to help with complex reasoning. Target group 
hierarchies allow designers to group mistakes and concepts together and ensure that they are remediated at the most 
appropriate Bme (i.e., Hard concepts will be remediated before easy concepts). Timing and other types of human-like 
remediation require the ICAT; other low-level mistakes which do not require much reasoning include: Incomplete- If the task 
requires a number of inputs, the interface can check that they have all been entered before allowing the student to proceed. By 
catching empty fields early in the process, the student may be saved the frustration of having to look through each entry to try 
and find the empty one. Empty- A simple check for the system is to look and see if anything has been selected or entered. If 
nothing has been selected, It may be appropriate for the system to generate a message stating "You must complete X before 
proceeding" Numbers not matching- Another quick check is matching numbers. As in the journalization activity, is often useM 
to put a quick interface check in place to make sure numbers which must match do. Small data entry mistakes are often better 
remediated at the interface level than at the tutor or coach level (when they are not critfcal to the learning objectives of the 
course). There are two main issues which must be remembered when using the interface to remediate errors. First, make sure 
the interface is remediating low level data entry errors. Second, make sure the feedback looks and feels different from the ICAT 
feedback. The interface feedback should look and feel like it is generated from the system while the ICAT feedback must look as 
if it were generated from an intelligent coach who is watching over the student as he works. 

Creating the Target Group Hierarchy- Target groups are sets of targets which are evaluated as one. Returning to the 
severity principle of the feedback theory, it is clear that the tutor needs to identify how much of the activity the student does not 
understand. Is it a global problem and the student does not understand anything about the acli^«ty? Or. is it a local problem and 
the student simply is confused over one concept? Using the feedback algorithm described eartier. the tutor will return the highest 
target group in which there is feedback. This algorithm requires that the designer start with large target groups and make sub- 
groups Which are children of the larger groups. The ICAT allows students to group targets in more than one category. Therefore 
a debit target for transaction thirteen can be in a target group for transaction thirteen entries as well as a target group about 
debits and a target group which includes all source documents. Target should be grouped with four key ideas in mind. Target 
groups are grouped according to; Concepts taught; Interface constraints; Avoidance of information overload and Positive 
reinforcemenL 

The most important issue when creating target groups is to aeate them along the concepts students need to know to 
achieve the goal. Grouping targets into groups which are analogous to the concepts a student needs to know, allows the tutor to 
review the concepts and see which concepts confuse the student. As a first step, a designer should kfenHfy in an unstructured 
manner all of the concepts in the domain. This first pass will be a large list which includes concepts at a variety of granularities, 
from small specific concepts to broad general concepts. These concepts are most likely directly related to the learning objectives 
of the course. With all of the concepts defined, designers need to idenUfy all of the targets which are in each target group. Some 
targets will be in more than one target group. When a target is in more than one target group, it means that there is some type of 
relationship such as a child relationship or a part to whole relationship. The point is not to create a structured list of concepts but 
a comprehensive list. Structuring them into a hierarchy will be the second step of the process. 
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• Notes: 



Loads from Database or Document based on values 
of m_StorageTypeTask and m_StorageTypeStudent 



extern °C" 
{ 

long _export WINAPI TuResumeStudent(long StudentID, long TaskID, int frcmSubmissionSeqID ); // Resumes a 
Student's work for ttie Task at the specified Submission 
} 

extern "C" 
{ 

long _export WINAPI TuLoadArctiivedSubmissions(iong StudentID, long TaskID. int fromSubmissionSeqID. int 
loSubmissionSeqID); // Loads Archived Submissions For a Student's work in a Task 
} 

extern "C 
{ 

long „export WINAPI TuUseArchivedSubmissions(inl n); // Replays n Archived submissions for debugging 

} 

extern "C 
{ 

long _export WINAPI TuSaveCurrentStudentQ; // Saves Current Student's work to DB 

} 

extern "C 
{ 

long _export WINAPI KillEngine( long ITaskID); // Delete all Dynamic objects before shutdown 
' Function Return 
* Variables: TUT_ERR_OK 



long _export WINAPI TuSetTaskDocPathName{ LPCSTR fnm ); 



•Name: TuSetFeedbackFileName 

* Purpose: To set path and name of file to use for holding feedback 
•Input 

•Parameters: LPCSTRfnm 

Path and name of file to use for holding feedback 

'Output 

* Parameters: none 

' Function Return 
Variables: TUT_ERR_OK 



extern °C" 
{ 

long ^export WINAPI TuSetFeedbackFileName( LPCSTR fnm ); 



* Name: TuSetFeedbackPrevFiteName 

* Purpose: To set path and name of file to use for holding previous feedback 

* Input 

•Parameters: LPCSTRfnm 

Path and name of file to use for holding previous feedback 

* Output 

* Parameters: none 

' Function Return 

* Variables: TUT_ERR_OK 

* Notes: 



long __export WINAPI TuSetFeedbackPfevFileName( LPCSTR fnm ); 
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* Name: 



TuSetLogFileName 

To set path and name of file to use for full logging 



* Purpose: 

* Input 



* Parameters: 



LPCSTR fnm 



Path and name of file to use for full logging 



' Output 

* Parameters: none 

' Funcfion Return 

* Variables: TUT_ERR_OK 

* Notes: 



extern "C" 
{ 

long __export WINAPi TuSetLogReName( LPCSTR fnm ); 

} 
!• 

•Name: TuSetLogLoadFileName 

* Purpose: To set path and name of file to use for load logging 

* Input 

•Parameters: LPCSTR fnm 



' Output 

' Parameters: none 

' Function Return 

' Variables: TUT_ERR_OK 

Notes: 



extern "C" 
{ 

long __export WINAPI TuSetLogLoadFileName{ LPCSTR fnm ); 



Path and name of file to use for load logging 



/• 
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Name: TuSelogStudentFileName 

Purpose: To set path and name of file to use for student logging 

Input 

Parameters: LPCSTR fnm 

Path and name of file to use for student logging 

Output 

Parameters: none 

Function Return 

Variables: TUT_ERR_OK 



long _export WINAPI TuSetLogStudentFileName{ LPCSTR fnm ); 



* Name: TuSetLogSubmissionFileName 

* Purpose: To set path and name of file to use for submission logging 

* Input 

* Parameters: LPCSTR fnm 

Path and name of file to use for submission logging 

' Output 

* Parameters: none 

' Function Return 

' Variables: TUT__ERR_OK 



extern "C" 
{ 

long _expon WINAPI TuSetLogSubmissionFileName( LPCSTR fnm ); 
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} 



* Name: TuSelogErrFileName 

* Purpose: To set path and name of file to use for error logging 

* Input 

•Parameters: LPCSTRfnm 

Path and name of file to use for error logging 

'Output 

* Parameters: none 

* Function Return 

* Variat)Ies; TUT_ERR_OK 
' Notes: 



extern "C" 
{ 

long __export WINAPI TuSetLogErrFileName{ LPCSTR fnm ); 



TuSefTrace 

To turn Trace on and off 



* Name: 

* Purpose: 

* Input 

* Parameters: int TraceStatus 
TUT_TRACE_ON :Tum Trace On 
TUT_TRACE_OFF :Turn Trace Off 

* Output 

' Parameters: none 



* Function Return 

* Variables: Previous Trace Status Value 
TUT_TRACE_ON 
TUT_TRACE_OFF 



TUT_ERR_INVALID_TRACE_STATUS 
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* Notes: 



long _export WINAPI TuSetTracef int TraceStatus ); 



Name; TuSetTrack 

Purpose: To turn Tracking on and off. While tracking is on 

all work the user does and all feedback the user receives 
is kept. While Tracking is off only the most recent work is kept. 

Input 

Parameters: int TrackStalus 

TUT_TRACK_ON :Tum Tracking On 
TUT_Tf^CK„OFF :Tum Tracking OU 

Output 

Parameters: none 
Function Return 

Variables: Previous Trace Status Value 
TUT_TRACK_ON 
TUT_TRACK_OFF 

TUT_ERR_INVALID_TRACK_STATUS 

Notes: 



long __export WINAPI TuSetTrack( int TrackStatus ); 

} 

Simulation Engine 

The idea is for the designer to model the task that he wants a student to accomplish using an Excel spreadsheet. Then, 
have an algorithm or engine that reads all the significant cells of the spreadsheet and notifies the Intelligent Coaching Agent with ' 
the appropriate informafon (SourceltemlO, TargetID and Attribute). This way, the spreadsheet acts as a central repository for 
student data, contains most of the calculations required for the task and in conjunction with the engine handles all the 
communication with the ICA. The task is self contained in the spreadsheet, therefore the designers no longer need a graphical 
user interface to functionally test their designs (smart spreadsheet. Once the model and feedback for it are completely tested bv 



aesigners, developers can incorporate the spreadsheet in a graphical user interface, e.g., Visual Basic as a development 
platform. The simulation spreadsheet is usually invisible and populated using functions provided by the engine. It is very 
important that all modifications that the ICA needs to know about go through the engine because only the engine knows how to " 
call the ICA. This significantly reduced the skill level required from programmers, and greatly reduced the time required to 
program each task. In addition, the end-product was less prone to bugs, because the tutor management was centralized. If there 
was a tutor problem, we only had to check on section of code. Rnally. since the simulation engine loaded the data from a 
spreadsheet, the chance of data inconsistency between the tutor and the application was nil. 

Figure 25 is a block diagram setting forth the architecture of a simulation model in accordance with a prefen-ed 
embodiment The Simulation Object Model consists of a spreadsheet model, a spreadsheet control object, a simulation engine 
object, a simulation database, input objects, output objects, list objects and path objects. The first object in our discussion is the 
Spreadsheet object The Spreadsheet is the support for ail simulation models. A control object that is readily integrated with the 
Visual Basic development plat. The control supports printing and is compatible with Microsoft Excel spreadsheets. With that in 
mind, designers can use the power of Excel formulas to build the simulation. The different cells contained in the spreadsheet 
model can be configured as Inputs. Outputs or Usts and belong to a simulation Path. All cells in the spreadsheet that need to be 
manually entered by the designer or the student via the GBS application are represented by input objects. Every input has Uie 
following interface: 



Field Name 


Data 
Type 


Description 


InputlD 


long 


Primary Key for the table 


TaskID 


long 


TaskID of the task associated with the input 


PaUilD 


long 


PathID of the path associated with the input 


InputName 


sti'ing'S 
0 


Name of the input 


InputDesc 


string*2 
55 


Description of the input 


ReferenceNam 

e 


string's 
0 


Name of the spreadsheet cell associated with the input 


TutorAware 


boolean 


Whether the ICA should be notified of any changes to the input 


SourcellemID 


long 


SourceltemID if input is a distinct input; 0 if input is a drag drop 
input 


TargetID 


long 


TargetID of the input 


Row 


long 


Spreadsheet row number of the input speed optimization 


Column 


long 


Spreadsheet column number of the input speed optimization 


SheetName 


string *5 
0 


Sheet name were the input is located -> speed optimization 



This information is stored for every input in the Input table of the simulation database (ICASim.mdb). Refer to Ihe 
example below. When designers construct their simulation model, tfiey must be aware of the fact that there are 2 types of 



inputs: Distinct Input S Drag & Drop Input. The Distinct Input consists of a single spreadsheet cell that can be filled by the 
designer at design time or by the GBS application at run time via the simulation engine object's methods. The purpose of the cell 
is to provide an entry point to thesimulation model. This entry point can be for example an answer to a question or a parameter 
to an equation. If the cell is TutorAware (all inputs are usually TutorAware), the ICA wffl be notified of any changes to the cell. 
Vi/hen the ICA is notitied of a change two messages are in fact sent to the ICA: An ICANofifyDestroy message with the input 
information i.e.. SourceltemlD, TargetID and null as Attribute. This message is to advise the ICA to remove this infomiation from 
its memory. An ICANotifyCreate message with the input information i.e.. SourceltemlD, TargetID, Attribute {cell numeric value) . 
This message is to advise the ICA to add this infomriation to its memory. A Distinct Input never requires that a user answer a 
mathematics question. 

These are the steps required to configure that simulation: Define a name for cell C2 in Excel. Here we have defined 
"Disfinci Jnput". In the ICA. define a task that will be assigned to the simulation. Ex: a TaskID of 123 is generated by the ICA. In 
the ICA, define a Target for the input Ex a TargetID of 4001 is generated by the ICA. In the ICA, define a Sourceltem for the 
input. Ex: a SourceltemlD of 1201 is generated by the ICA. Associate the input to a path (refer to Path object discussion). Add 
the information in the Input table of the simulation engine database. A record in an Input table is presented betow. 



InputID: 


12345 


TaskID: 


123 


PathID: 


1234 


InpulName: 


Quesfion 1 input 


InputOesc: 


Distinct input for Question 1 


ReferenceNam 

e: 


Distinct_lnput 


TutorAware: 


True 


SourceltemlD 


1201 


TargetID: 


4001 


Row: 


2 


Column: 


3 


SheetName: 


Sheetl 



The Row, Column and SheetName are filled in once the user clicks "Run Inputs/Outputs". The simulation engine 
decodes the defined name (Reference Name) that the designer entered, and populates the table accordingly. This is an 
important step. We had several occasions when a designer would change the layout of a spreadsheet, i.e., move a defined name 
locafion. then forget to perform this step. As such, bizarre data was being passed to the tutor; whatever data happened to reside 
in the old row and column. Once the configuration is completed, the designer can now utilize the ICA Utilities to test the 



The drag & drop input consist of two consecutive spreadsheet cells. Both of them have to be filled by the designer at 
design time or by the GBS application at run time via the simulation engine object's methods. This type of input is used usually 
when the user must choose one answer among a selection of possible answers. Drag & drop inputs are always TutorAware. The 



left most celt contains the SourceltemID of the answer picked by the user (every possible answer needs a SourceltemID) and 
the rightmost cell can contain a numeric value assodated to that answer. You need to define a name or ReferenceName in the 
spreadsheet for the rightmost cell. ICA will be notified of any changes to either one of the cells. When the ICA is notified of a 
change two messages are in fact sent to the ICA; An ICANotifyDestroy message with the input information i.e.. SourceltemID 
before the change occurred, TargetID of the input and the Attribute value before the change occurred. An ICANotifyCreate 
message with the input information i.e.. SourceltemID after the change occurred, TargetID of the input and the Attribute value 
after the change occun'ed. 

These are the steps required to configure that section of the simulation; Define a name for cell C1 1 in Excel. Here we 
have defined "DragDrop Jnput"; Let's use the same TaskID as before since Question 2 is part of the same simulation as 
Question 1 . Ex; TaskID is 123; In the ICA, define a Target for the input. Ex; a TargetID of 4002 is generated by the ICA; In the 
ICA, define a Sourceltem for every possible answer to the question. Ex; SourceltemlDs 1202 to 1205 are generated by the ICA; 
Associate the input to a path (refer to Path object discussion); and Add the information in the Input table of the amulation engine 
database. A record in the Input table in accordance with a preferred embodiment is presented befow. 



InputlD; 


12346 


TaskID; 


123 


PalhID; 


1234 


InpulName; 


Question 2 input 


InputDesc; 


Drag & Drop input for Question 2 


ReferenceNam 

e; 


DragDrop_lnput 


TutorAware; 


True 


SourceltemID 


0 


TargetID; 


4002 


Row; 




Column; 


3 


SheetName; 


Sheetl 



The list object consists of one cell identifying the list (cell #1) and a series of placehoWer rows resembling drag & drop 
inputs (cells #1.1 - l.n to cells #n.1- n.n). The list is used usually when the user must choose multiple elements among a 
selection of possible answers. Cell #1 must have a uniquely defined name also called the list name. Cells #1.1 to #n.1 can 
contain the SourceltemID of one possible answer picked by the user (every possible answer needs a SourceltemID). The content 
of these cells must follow this fomriat : -ListName-SourceltemlD. Cells #1.2 to #n.2 will hold the numeric value (attribute) 
associated with the SourceltemID in the cell immediately to the left. Cells #1.3 - l.n to #n.3 - n.n are optional placeholders for 
data assoaated with the answer. KEY NOTE; When implementing a list object the designer must leave all the ceiis under #n.1 to 
#n.n blank because this range will shift up every time an item is removed from the list. 
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Every list has the following interface: 



Field Name 


Data 
Type 


Description 


LislID 


long 


Primary Key for the tabie 


TaskID 


long 


TaskID of the task associated with the list 


PathID 


long 


PathID of the path associated with the list 


ListName 


string*50 


Name of the list 


ListDesc 


string*25 
5 


Description of the list 


ReferenceNarri 

e 


string*50 


Name of the spreadsheet cell associated with the list 


TutorAware 


boolean 


Whether the ICA should be notified of any changes to the list 


TargetID 


long 


TargetID of the output 


TotalColumns 




Total number of data columns 


Row 


long 


Spreadsheet row number of the output -> speed optimization 


Column 


long 


Spreadsheet column number of the output speed 
optimization 


SheetNlame 


string 50 j Sheet name were the input is located -> speed optimization 



Use of a list is demonstrated by continuing our math test. The math question in this example invites the user to select 
multiple elements to construct the answer. These are the steps required to configure that section of the simulation. Figure 26 
illustrates the steps for configuring a simulation in accordance with a preferred embodiment. Define a name for cell C23 in Excel 
Here we have defined -The_Lisr. Let's use the same TaskID as before since Question 3 is part of the same simulation as 
Question 1 and 2. Ex: TaskID is 123. In the ICA, define a Target for the list. Ex: a Target© of 4006 is generated by the ICA. In 
the ICA, define a Sourceltem for every item that could be placed in the list. Ex: the following SourceltemlDs 1209, 1210, 121 1 
1212, 1213, 1214 are generated by the ICA. Associate the list to a path (refer to Path object discussion). Add the information in 
the List table of the simulation engine database. 

A record in the Usf table in accordance with a preferred embodiment is 

presented in the table appearing below. 



ListID: 


12346 




TaskID: 


123 




PathID: 


1234 




ListName: 


Question 3 list 


ListDesc: 


List for Question 3 


ReferenceNam 

e: 


The_List 


TutorAware: 


True 



TargetID: 


4006 


TotalColumns: 


1 


Row: 


23 


Column: 


3 


SheetName: 


Sheetl 



Ail cells in the spreadsheet that are result of calculations (do not require any external input) can be represented by 
output objects. Every output has an interface as outlined in the table below. 





Type 


Description 


OutputID 


long 


Primary Key for the table 


TaskiD 


long 


TaskID of the task associated with the output 


PathID 


long 


PathID of the path associated with the output 


OutputName 


string*50 


Name of the output 


OutputDesc 


string'25 
5 


, DesCTiption of the output 


ReferenceNam 

e 


string*50 


Name of the spreadsheet cell associated with the output 


TutorAware 


boolean 


Whether the ICA should be notified of any changes to the 

output 


SourceltemID 


long 


SourceltemID of the output 


TargetID 


long 


TargetID of the output 


Row 


long 


Spreadsheet row number of the output -> speed 
optimization 


Column 


long 


Spreadsheet column number of the output -> speed 
optimization 


SheetName 


string*50 


Sheet name were the input is located ^ speed 
optimization 



All this information is stored for every output in the Output table of the simulation database (ICASim.mdb). When 
designers construct their simulation model, they must be aware of the fact that there is only 1 type of Outputs : the Distinct 
Output. A Distinct Output consists of one and only one spreadsheet cell that contains a formula or a result of calculations. The 
existence of Output cells is the main reason to have a simulation model. If the cell is TutorAware, the ICA will be notified of any 
1 0 changes to the cell when all outputs are processed otherwise the ICA will be unaware of any changes. When the ICA is notified 
of a change two messages are in fact sent to the ICA: An ICANotifyDestroy message with the output infomiation i.e , 
SourceltemID, TargetID and null as Attribute. This message is to advise the ICA to remove this infonnation from its memory. An 
ICANotifyCreate message with the output information i.e., SourceltemID. TargetID, Attribute (cell numeric value) . This message 
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IS to auvise uie lUH lo am inis inrormation to its memory. As opposed to Distinct Inputs and Drag & Drop inputs whidi notify the 
ICA on every change. Distinct Outputs are processed in batch just before asking the fCA for feedback. To notify the ICA of the 
total dollar amount of the items in the list. We definitely need a Distinct Output for that The output will contain a sum fomiula. 
Define a name for cell C24 in Excel. Here we have defined 'Distinct_Outpur.Lefs use the same TaskID as before since Question 
3 IS pa.1 of the same simulation as Question 1 and 2. Ex: TaskID is 123. In the ICA, define a Target for the output. Ex; a ' 
Target© of 4005 is generated by the ICA: in the ICA, define a Sourceltem for the output. Ex: a SourceltemID of 121 5 is 
generated by the ICA. Associate the output to a path (refer lo Path object discussion). 
Add the infomiation in the Output table of the simulation engine database. 

A record in an Output table in accordance with a preferred embodiment is presented below. 



OulputiD" 


12347 


TaskID: 


123 


PathID: 


1234 


OutpufName: 


Question 3 output 


OutputDesc: 


Distinct Output for Question 3 


ReferenceNam 

e: 


Distinct_Output 


TutorAware: 


True 


SourceltemID 


1215 


TargetID: 


4005 


Row: 


24 


Column: 


6 


SheetMame: 


Sheetl 



Paths are used to divide a simulation model into sub-Simulations meaning that you can group certain inputs, outputs 
and lists together to fomn a coherent subset or path. Every path has the following interface: 



Field Name 


Data 

Type 


Descriptioft 


PathID 


long 


Primary Key for the table 


TaskID 


long 


TaskID of the task associated with tfie path 


PathNo 


long 


Numeric value assodated to a path 


Pathname 


string* 

50 


Name of ttie path 


PathDesc 


string* 

255 


Description of the path 



All this information is stored for every path in the path table of the simulation database (ICASim.mdb). 
The simulation engine is the interface between the model, the simulation database and the InteHigent Coaching Agent. 
The simulation engine is of interest to the designer so that he can understand the mechanics of it all. But it is the developer of 



app,^uu,.o uainy u,« «,y,Me tnai snouio Know me aeiais or me intenace {methods & properties) exposed by the engine and 
the assodated algorithms. Once the designer has constructed the simulation model (Excel Spreadsheet) and configured all the 
inputs, outputs & lists, he is ready to test using the test bench induded in the ICA Utilities (refer to ICA Utilities documentation). 
The developer, in turn, needs to implement the calls to the simulation engine in the 6BS applicatbn he's building. The fotowing 
lisi Identifies the files that need to be included in the Visual Basic projed to use the simulation workbench : 



wSimEng.ds 


Simulafion Engine dass 


wSimEng.bas 


Simulation Engine module (this module was introduced only for speed 
purposes because all the code should theoretically be encapsulated in the 
dass) 


wConst.bas 


Intelligent Coaching Agent constant dedaration 


wDedare.bas 


Intelligent Coaching Agent DLL interface 


wica.ds 


Intelligent Coaching Agent dass 


wtca.bas 


Intelligent Coaching Agent module (this module was introduced only for 
speed purposes because all the code should theoretically be encapsulated 
in the dass) 



To have a working simulafion, a developer places code in different strategic areas or stages of the application. There's 
the Initial stage that occurs when the form containing the simulation front-end loads. This is when the simulation model is 
initialized. There's the Modification stages that take place when the user makes changes to the front-end that impacts the 
simulation model. This is when the ICA is notified of what's happening. There's the Feedbadc stage when the user requests 
infomiation on the work done so far. This is when the simulation notifies the ICA of all outpufchanges. Finally, there's the Final 
stage when the simulation front-end unloads. This is when the simulation is saved to disk. 

The different stages of creating a simulatton, including the Visual Basic code involved, are presented below. IniHal 
stage; 1 Creating the ICA & the simulation engine object: Code: Set moSimEngine = New dassSimEngine; Set moICA = 
New classlCA; Description : The first step in using the simulation engine is to create an instance of the dass dassSimEngine and 
also an instance of the dass classlCA. Note that the engine and ICA should be module level object "mo" variables. 2. Loading 
the simulation; Code: IRet = moSimEngine.OpenSimulalion(App.Path & DIR_DATA & FILE_SIMULATION. 
Me.bookSimulation): IRet = moSimEngine.LoadSimulation{mllCATasktD. App.Path & DIR_DATABASE & DB_StMULATION, 1); 
DesgiMQn: After the object aeafion, the OpenSimulatron and LoadSimulation methods of the simulation engine object must be 
called. The OpenSimulation method reads the spedfied Excel 5.0 spreadsheet file into a spreadsheet control. The 
LoadSimulation method opens the simulation database and loads into memory a list of paths, a list of inputs, a list of outputs and 
a list of lists for the specific task. Every method of the simulation engine will return 0 if it completes successfully otherwise an 
appropriate error number is returned. 3. Initializing and loading the Intelligent Coaching Agent CotelRef = 
molCA.Initiali2e(App.Path & T & App.EXEName & ".ini". App.Path & DIR_DATABASE. App.Path & DIRJCADOC. App.Path & 
T); IRet = molCA.LoadTask(mllGATasklD, ICAStudentStarlNew); Description: The simulafion engine only works in conjunctran 
with the ICA. The Initialize method of the ICA objed reads the application .ini file and sets the Tutor32.dll appropriately. The 
LoadTask method tells the ICA (Tutor32.dll) to loacj the .tut document associated to a spedfic task in memory. From that point 
on. the ICA can receive notifications. Note: The .tut document contains all the element and feedback structure of a task. Ex: 
SourcePages, Sourceltems. TargetPages. Targets, etc...4. Restoring the simulation; CodeL«Code to reset the simulation 



When starting over»; «Code to load the controls on the simulation front-end»; IRet = moSimEngine.Runlnputs(sPaths. True); 
IRet = moSimEngine.RunOutputs(sPaths, True); IRet = moSimEngine.RunUsts{sPaths, True); Call molCA.Submit(0); Call 
molCA SetDirtyFlag(0, False); Description: Restoring the simulafion involves many things: clearing all the inputs and lists when 
the user is starting over; loading the interface with data from the simulation model; invoking the Runlnputs. RunOutputs and 
RunUsts methods of the simulation engine object in order to bring the ICA to it's original state; calling the Submit method of the 
ICA obiecl with zero as argument to trigger all the rules; calling the SetDirtyFlag of the ICA object with 0 and false as arguments 
in order to reset the user's session. Running inputs involves going through the list of TutorAware inputs and notifying the ICA of 
the SourceltemID, TargetID and Attribute value of every input. Running lists involves going through the list of TutorAware lists 
and notifying the ICA of the SourceltemID. TargetID and Attribute value of every item in every list. The TargetID is unique for 
every item in a list. 

Running outputs involves going through the list of TutorAware outputs and notifying the ICA of the SourceltemID, TargetID and 
Attribute value of every output. Modification stage 1 . Reading inputs & outputs; Code: Dim sDataArray(2) as string; Dim 
vAftribute as variant; Dim ISourceltemID as long; Dim ITargetlD as longJRel = moSimEngine.ReadReferenceCDistinct Jnput". 
vAtfribute. ISourceltemID, ITargetlD, sDataArray) 

Description: The ReadReference method of the simulation object will return the attribute value of the input or output 
referenced by name and optionally retrieve the SourceltemID. TargetID and related data. In the current example, the attribute 
value, the SourceltemID, the TargetID and 3 data cells will be retrieved for the input named Distinct_lnput. 

Description: The simulation engine object provides basic functionality to manipulate lists. 

The ListAdd method appends an item(SourceitemiD, Attribute. Data array) to the list. Let's explain the aigorittim. First, 
we find the top of the list using the list name. Then, we seek the first blank cell underneath the top cell. Once the destination is 
determine, the data is written to the appropriate cells and the ICA is notified of the change.The ListCount method returns the 
number of items in the spedfied list. The algorithm works exactly like the ListAdd method but returns the total number of items 
instead of inserting another elemenLThe UstModify method replaces the specified item with the provided data. Let's explain the 
algorithm. First, we find the top of the list using the list name. Second, we calculate the row offset based on the item number 
specified. Then, the ICA is notified of the removal of the existing item. Finally, the data related to the new item is written to the 
appropriate cells and the ICA is notified of the change. The ListDelete method removes the specified item. The algorithm works 
exactly like the UstModify method but no new data is added and the cells (width of the list set by 'Total Columns') are deleted 
with the -move cells up' parameter set to tnie. Keep this in mind, as designers often enter the wrong number of columns in the 
Total Columns parameter. When they overestimate the Total Columns, UstDelete will modify portions of the neighboring list, 
which leads to erratic behavior when that list is displayed. 

SYSTEM DYNAMICS IN ACCORDANCE WITH A PREFERRED EMBODIMENT 

To use system dynamics models in the architecture, an engine had to be created that would translate student work into 
parameters for these models. A complex system dynamics model to interact with an exisUng simulafion architecture is discussed 
below. The system dynamics model provides the following capabilitiesJkllow designers to build and test their system dynamics 
models and ICA feedback before the real interface is builLReduce the programming complexity of the acfivifies.Centralize the 
interactions with the system dynamics models.System Dynamics Engine As with the simulation engine, the designer models the 
task that he/she wants a student to accomplish using a Miaosoft Excel spreadsheet. Here, however, the designer also aeates a 
system dynamics model (described later). The system dynamics engine will read all of the significant cells within the simulation 



moaei (txcei) ana pass ttiese values to the system dynamics model and the ICA. After the system dynamics model runs the 
information, the output values are read by the engine and then passed to the simulation model and the IC/l 

Figure 27 is a block diagram presenting the detailed architecture of a system dynamics model in accordance with a 
preferred embodiment Once the simulation model, system dynamics model and feedback are completely tested by designers, 
developers can incorporate the spreadsheet in a graphical user interface, e.g., Visual Basic as a development platfom,. Figure 
27 illustrates that when a student completes an activity, the values are passed to the system dynamics engine where the values 
are then passed to the system dpamics model (as an input), written to the simulation model and submitted to the ICA. When the 
system dynamics model is played, the outputs are pulled by the engine and then passed to the simulation model and the ICA. 
Note that the simulation model can analyze the output from the system dynamics model and pass the results of this analysis to 
the ICA as well. The simulation model can then be read for the output values and used to update on-screen activity controls 
(such as graphs or reports).lt is very important that all modifications that the ICA and system dynamics model need to know 
about go through the engine because only the engine knows how to call these objects. This significantly reduces the skill level 
required from programmers, and greatly reduces the time required to program each task. In addition, the end-product is less 
prone to bugs, because the model and tutor management wi« be centralized. If there is a problem, only one section of code 
needs to be checked. Finally, since the engine loads the data from the spreadsheet, the chance of data inconsistency between 
the ICA, the system dynamics model and the application is insignificant. 

The system dynamics model generates simulation results over time, based on relationships between the parameters 
passed into it and other variables in the system. A system dynamics object is used to integrate with Visual Basic and the 
spreadsheet object. The object includes logic that controls the time periods as well as read and write parameters to the system 
dynam.es model. With \flsual Basic, we can pass these parameters to and from the model via the values in the simulation otqect. 
The system dynamics object also controls the execution of the system dynamics model. What this means is that after all of the 
parameter inputs are passed to the system dynamics model, the engine can run the model to get the parameter outputs. The 
system dynamics object allows for the system dynamics models to execute one step at a Kme, all at once, or any fixed number of 
time periods. When the system dynamics model runs, each step of the parameter input and parameter output data is written to a 
■backup' sheet for two reasons. First, the range of data that is received over time (the model playing multiple times) can be used 
to aeate trend graphs or used to calculate statistical values. Second, the system dynamics model can be restarted and this audit 
trail of data can be transmitted into the model up to a specific point in time. What this means is that the engine can be used to 
play a simulaUon back in time. When any event occurs within the system dynamics engine, a log is aeated that tells the 
designers what values are passed to the simulation model, system dynamics model and ICA as well as the current time and the 
event that occurred. The log is called "SysDyn.log' and is aeated in the same location as the application using the engine. As 
with the spreadsheet object, the system dynamics object allows a large amount of the calculations to occur in the system 
dynamics model and not in the acti^nty code, again placing more control with the activity designers. Model objects are used to 
configure the system dynamics models with regard to the time periods played. Models are what the parameter inputs and 
parameter outputs (discussed later) relate to. so these must be created first. Every model has the following application 
programming interface: 



Field Name 


Data 

Type 


Description 


ModellD 


Long 


Primary Key for the table 
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TaskID 


Long 


TaskID of Bie task associated witti the model 


ModelName 




String' 


Name of the model (infonnational purposes) 


ModeiDesc 


50 


String* 


Description of the model (informational purposes) 


SysDynModel 


50 


String* 


Filename of the actual system dynamics model 


Start 


Long 


Start time to play modal 


Stop 


Long 


Stop time to play model 


Step 


Long 


Interval at which to play one mode! step and record 

data 



This information is stored in the model table of the simulation database (ICASim.mdb). All of the values that will need to 
be manually entered by the student that are passed into the system dynamics model are configured as parameter inputs 
(PInputs) objects. Every PInput has an interface as detailed below. 



Field Name 


Data Type 


Description 


PinputID 


long 


Primary Key for (he table 


TaskID 


long 


JaskID of the task associated with the parameter input 


ModellD 


long 


!D of the model associated with the parameter input 


InputName 


string *50 


Name of the parameter input (informational purposes) 


InputDesc 


string*255 


Description (informational purposes) 


ReferenceName 


string'50 


Name of the spreadsheet ceil associated with the 
parameter input' 


SimReferenceName 


string*50 


Name of the associated parameter in the system 
dynamics model 


TutorAware 


boolean 


Whether the ICA should be notified of any input 
CHANGES 


SourceltemID 


ong 


SourceltemID of the parameter input 


TargetlD 


long 


TargetlD of the parameter input 


Row 


long 


Spreadsheet row number of the parameter input 


Column 


long 


Spreadsheet column number of the parameter input 


SheetName j string*50 


Sheet name were the parameter input is located 



All of this infomiaHon is stored for every parameter input in the PInput table of the simulation database (ICASim mdb) 
PInputs consist of one spreadsheet cell that can be populated byadesigner at design time orbytheGBS application at 



vecne system oynamicsengineoDjecrsmethods. The purpose Of me cell is to provide an enu^ 

system dynamics modds. An example ofan entry point would be the interest rate parameter in me 

The ICA,snot,fied of anychanges to the cell when an appropriate activity transpires. VVhen the ICAi^ 

rriessagesaresenttothelC/lThefirstisantCANoOfyDestroymessagewiththeparameterinputinformati^^ SourceltemlD 

TargetlOandnullasanattn-bute.ThismessageissenttoinformthelCAtoremoveinformafonfromitsmemory.Tte 

messageisanlCANotifyCreatemessagewiththeparameterinputinformationi.e.,SourceltemlD.TargetlD Attribute 

numerc value). This message ad^nses the ICA to add this infomiationtoitsmemory.APlnpu. table record in accorda^^ 
prefenred embodiment is presented below. 



PInputID; 


12345 


TaskID; 


123 


MbdellD: 


1 


InputName; 


Interest Rate input 




Interest Rate input into interest 
calculation model 


ReferenceName: 


lnterest_Rate 


SimReferenceNam 


Param_lnterest_Rate 


TutorAware; 


True 


SourceltemlD 


\1201 


Target©; 


4001 


Row: 


6 


Column: 


3 


SheetName: 


Sheetl 



Once the configuration « completed, the designer can also use the ICA Utilities to test the simulation The Row 
column and SheetName values are automatfcally populated when me designer runs the parameters in tte System Dynamics 

workbench in the ,CA Utilities. The following information provides details desaibing me interaction compon^ 
with a prefened embodiment. 



Title 


Description ■ — 


Procedural tasks (w/drag 

drop) 


Tasks which require me construcUon of some kind of report wim evidence 
dragged and dropped to justify conclusions 


Procedural tasks (w/o drag 

drop) 


New task designs mat are procedural in nature, have very little branching, and 
always have a conecf answer. 


Ding Dong task 


rasks mat interrupt me student while working on someming else. This template 
ncludes interviewing to determine me problem, and a simpte checkbox form to 
decide how to respond to me situation. 



Analyze and Decide (ANDIE) 

task 


Most (Mmmonly used for static root cause analysis, or identification tasks. 
Developed on SBPC as a result of 3 projects of experience redesigning for the 
same skill. 


Evaluate Options (ADVISE) 


Used for tasks that require leamer to evaluate how different opfions meet stated 
goals or requirements. Developed at SBPC after 4 projects experience 
redesigning for the same skill. Does not allow drag drop as evidence. 


Run a company task 


Time based simulation where student "chooses own adventure". Each period the 
student selects from a pre-defermined list of actions to take. Developed on SBPC 


Use a model task 


When user needs to interact vnth a quantitative model to perform what if 
analysis. May be used for dynamic root cause analysis - running tests on a part 


ICA Dynamic Meeting Task 


Developed on BDM to mimic interaction styles from Coach and ILS EPA. 
Supports dynamic-rule based branching - will scale to support interactions like 
EnCORE defense meetings and YES. 


Manage Task 


Time based simulation where student manages resources. Human Resources 
Management, managing a budget, manage an FX portfolio. 


QVID Static Meeting Task 


Developed on Sim2 to support agenda-driven meetings where user is presented 
with up to 5 levels of follow-up questions to pursue a line of questioning. As they 
ask each question, if s follow-ups appear. 


Flow Chart Task 


VWI support most VISIO diagrams. Developed on Sim2 to support simple flow 


QVID Gather Data 
Component 


Static flat list of questions to ask when interviewing someone. Not used virfien 
nterviewing skills are being taught {use QVID Static meeting task). Supports 
hierarchical queslions and timed transcripts. 


Journalize Task 


Created to support simple journal entry tasks with up to 2 accounts per debit or 
credit. 


New Complex Task 


A new task that requires a simulation component 



The system dynamics engine is the interface between the simulation model, the system dynamics model, the simulation 
database and the intelligent Coaching Agent. The system dynamics engine is of interest to the designer so that she can 
understand the mechanics of it. Once the designer has constructed the simulation model (Excel Spreadsheet), built the system 
dynamics model (PowerSim) and configured all of the parameter inputs and parameter outputs, a test can be performed using 
the workbench included in the ICA UUlities (refer to ICA UUIities documentation). The developers, in turn, need to implement the 
calls to the system dynamics engine in the GBS application that is being built. The following list identifies the files that need to be 
included in the Visual Basic project to use the system dynamics engine. 
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WSysUynhng.cIs 


System dynamics Engine dass 


wSysDynEng.bas 


System dynamics Engine module (this module was introduced only for speed 
purposes because all the code should theoretically be encapsulated in the 
dass) 


wConstbas 


Intelligent Coaching Agent constant dedaration 


wDeclare.bas 


Intelligent Coaching Agent DLL interface 


wlca.ds 


Intelligent Coaching Agent dass 


wica.bas 


Intelligent Coaching Agent module (this module was introduced only for 
speed purposes because all of the code should theoretically be encapsulated 
in the dass) 



To utilize the system dynamics engine fully, the developer must place code in different strategic areas or stages of the 
application. Initial stage - the loading of the form containing the simulation front-end. This is when the simulation model and 
system dynamic engine are initialized. Modification stage - Takes place when the user makes changes to the front-end that 
impacts the simulation model Plnputs). This is when the ICA is notified of what's happening. Run stage - The system dynamics 
model is run and parameter outputs are received. Feedback stage - The user requests feedback on the work that they have 
performed. This is when the simulation notifies the ICA of all output dianges. Final stage - The simulation front-end unloads. 
This is when the simulation model is saved. These stages will be explained by induding the Visual Basic code involved as well as 
a short description of that code. 

Initial Stage Code In Accordance With A Preferred Embodiment 

1. Creating the ICA & the simulation engine objects: Code: Set moSysDynEngine New dassSysDynEngine; Set 
moICA = New dassICA; Description: The first step in using the system dynamics engine is to create an instance of tie 
dassSysDynEngine dass and also an instance of the dassICA class. Note that the engine and ICA should be module level 
object "mo" variables. 2. Loading the simulation: Code: IRet = moSysDynEngine.OpenSimulation{FlLE_SIM, Me.bookSim, 
True); IRet = moSysDynEngine.LoadSysDyn(mllCATask!D, DB.SIMUIATION, 1); IRet = 

moSysDynEngine.LoadModet(MODEL_NAME.mbTaskStarted); Description: After the object creation, the OpenSimulation. 
LoadSimulation and LoadModel methods of the system dynamics engine objed must be called. The OpenSimulation method 
reads the spedfied Excel 5.0 spreadsheet file {FILE_SIM) into a spreadsheet control (bookSim). The LoadSysDyn method opens 
the simulation database {DB_SIMULATION) and loads into memory a list of parameter inputs and a list of parameter outputs. 
The LoadModel method opens a system dynamics model (MODEL_NAME). Every method of the system dynamics engine will 
return 0 if it completes successfully otherwise an appropriate error number is returned. 3. Initializing and loading the 
intelligent Coaching Agent; Code: IRet = molCAJnitialize(App.Path & T & App.EXEName & ".ini-, App.Path & 
DIR_DATABASE, App.Path & DIRJCADOC, App.Path & T); IRet = molCA.LoadTask(mllCATasklD, ICAStudentStartNew); 
Description: The system dynamics engine only works in conjunction with the ICA. The Initialize method of the ICA object reads 
the application .ini file and sets the Tufor32.dll appropriately. The LoadTask method tells the ICA (Tutor32.dli) to load the .tut 
document assodated to a specific task in memory. From that point on, the ICA can receive notifications. Note: The .tut 
document contains all the element and feedback structure of a task. Ex: SourcePages. Sourceltems, TargetPages, Taigets. 
etc... 4. Restoring the simulation- Code: IRet - moSysDynEngine.RunPlnputs(MODEL_NA!VlE, True); IRet = 
moSysDynEngine.RunPOutputs(MODEL_NAME, True); IRet = moSysDynEngine.PassPlnputsAll; Call moiCA.Submit(O)- Cai! 
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molCA.SetDirtyFlag{0, False) Description: Restoring the simulation involves many things: dearing all of the parameter inputs 
and outputs when the user is starting over; loading the interface with data from the simulation model; invoking the PassPlnputsAII 
method of the system dynamics engine object in order to bring the ICA to its original state; invoking the RunPlnputs and 
RunPOutputs methods of the system dynamics engine object in order to bring the system dynamics model to it's original state; 

5 calling the Submit method of the ICA object to trigger the ICA to play all of the rules; calling »ie SetDirtyFlag of the ICA object to 

reset the user's session. Running parameters involves going through the list of TutorAware PInputs and POutputs and notifying 
the ICA of the SourceltemID, TargetID and Attribute value of every one.Modification Stage; 1. Reading parameter inputs & 
outputs; Code: Dim sDataArray(2) as string; Dim vAttribute as variant; Dim ISourceltemlD as long, ITargetID as longJRet = 
moSysDynEngine.ReadReferenceCinput.Name", vAttribute, ISourceltemlD. ITargetID, sDataArray). Description: The 

10 ReadReference method of the system dynamics object will return the attribute value of the parameter input or output referenced 

by name and optionally retrieve the SourceltemID, TargetID and related data. In the current example, the attribute value, the 
SourceltemID, the TargetID and 3 data cells will be retrieved for the parameter input named lnput_Name. 
2. Modifying parameter inputs Code: Dim vAttribute as variant; Dim ISourceltemlD as long; Dim sDataAn-ay(2) as string; 
vAttribute=9999; sDataAn-ay(0)="Data Cell #1"; sDataArray(1)=-Data Cell #2"; sDataAnray(2)="Data Cell #3"; IRet = 

15 moSysDynEngine.WriteReferenceClnput.Name", vAttribute, , sDataArray). Description: To modify a parameter input, call the 

WriteReference method of the system dynamics object and pass the PInput reference name, the new attribute value and 
optionally a data array (an additional information to store in the simulation model). The system dynamics engine notifies the ICA 
of the change. Run Stage 1 . Playing the System Dynamics Model; Code: IRet = 

moSysDynEngine.PlayModel{SYSDYN_PLAYSTEP); IblCurrentTime.Caption = moSysDynEngine.CurrentTime; and 
20 IblLastTime.Caption = moSysDynEngine.LastTime; Description: Playing the system dynamics model is also handled by the 

system dynamics engine. There are three ways that the models can be played, all at once, one step at a time (shovm above) or 
until a specific point in time. These are the parameters that are passed into the PlayModel method. Playing of the model 
generates the parameter output values and passes the Tutor Aware POutputs to the ICAT. The engine also keeps track of time 
and these values can be read using the CunentTime and LastTime properties. 2. Jumping Back in a System Dynamics 
25 Model Code: IRet = molCA.LoadTask(mllCATasklD, ICAStudentStartNew); IRet = 

moSysDynEngine.JumpBack(TIME_TO_JUMP_TO). Description: Because the system dynamics engine writes backup copies 
of the parameters passed to and from it, It can start over and resubmit these values back to the system dynamics model until a 
given period of time. To do this, the code would need to restart the ICA and then call the system dynamics engine to jump back 
to a given lime (T1ME_T0_JUMP_T0). Feedback stage 1. Triggering the ICA Rule engine; Code: IRet= 
30 molCA.Submit{ICoadilD); Description: Once the simulation has been processed, the Submit method of the ICA object must be 

called to trigger all the rules and deliver the feedback. This feedback wrill be written by the Tutor32.dll to two RTF fonnatted files. 
One file for previous feedback and one file for the current feedback. 

ICA Configuration in Accordance with a Preferred Embodiment 

Figure 28 is an overview diagram of the logic utilized for initial configuration in accordance with a prefen^ed 
35 embodiment. Since the structure of the feedback is the same as other on-line activities, the ICA can also be configured in the 

same manner. For ease of creation and maintenance of ICA feedback, it is recommended that the feedback is constructed so 
that only one rule fires at any point in time. Note that the organization of the example is one of many ways to structure the 
feedback. Step 1 : Create a map of questions and follow-up questions; Before designers start configuring the ICA, they should 
draw a map of the questions, videos and follow-up questions that they wish to use in the on-line meeting. This will give them a 



good understanding of the interactions as they configure the ICA. Step 2: Create a coach; All feedback is given by a coach. 
Create a specific coach for the on-line meeting. Step 3: Create the Source Items and Targets 

Every question will have one Source Item (1) and Target (2) assodated with it. These will be used by the ICA to show 
videos and fdlow-up questions. For organizational purposes and ease of reading, it is recommended that each Source Page ("0 

5 Intro") contain all of the follow up questions ("Intro Ql", "Intro Q2°, 'Intro Q3"). Targets can be created one per Source Item 

(shown here) or one per many Source Items. This is not very important, so long as there are distinct Source Item and Target 
associations. Once the Source Items and Targets have been created, associate them into SourceltemTargets (3) and give them 
a relevance of one. These are the unique identifiers which the ICA will use to fire rules and to provide feedback to the student. 
Step 4; Create the Parent Header (Video Information) Figure 29 is a display of video information in accordance with a preferred 

10 embodiment. Feedback (Coach Items) are organized into Target Groups (1). In Figure 29, each on-line question has one Target 
Group for ease of maintenance. Each TargetGroup must have at least one related Target (4). These are the SourceltemTarget 
mappings that were made at the end of Step 3. Next, Rules (2) are created to fire when the SourceltemTarget is mapped (a 
question Is clicked). Coach Items (3) are associated to a rule and represent the feedback which will be shown if the rule is fired. 
The ICA Utilities incorporate business simulation into a multimedia application. What this means is that there is now a middle 

15= layer between the application and the ICAT. These utilities, along with the simulation engine (described later), allow the 

architecture to be a front end to the simulation. Now, any changes to a simulation model do not need to be incorporated into 
code. The ICA Utilities and simulation engine work with simulation models created in Microsoft Excel. After the model is created, 
the designer uses the Defined Name function in Excel to flag specific cells that are to be used by the application and the ICA 
Utilities in accordance with a preferred embodiment. Figure 30 illustrates an ICA utility in accordance with a preferred 

20: embodiment. The ICA Utilities consist of six utilities that work with the Intelligent Coaching Agent Tool (ICAT) to incorporate 
business simulation with the multimedia application. 
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